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PART I 


SPECIFICATIONS 
Introduction 


The poteesies” 8001 is an eight color intelligent CRT data terminal 
designed as a replacement for teletypes and black and white CRT data terminals. 
It is a self-contained, desk top unit which offers, with the use of a modem, 
two-way data communications over common voice telephone lines or teletype 
compatible current loops. It can also be used in the stand alone mode as a 
complete desk top computer if equipped with the proper options. 


Basic System Specification 


Power: 105-125 volts, 60HZ, 250 watts 
Option 11: 205-250 volts, 50-60 HZ 


Temperature: +10°C to +40°C operating 
-30°C to +70°C storage 
Humidity: O to 95% non-condensing 
Package Size 17 1/2" high 
Desk Mount 19 3/8" wide 
Version: 22 1/2" long 
Keyboard > 3 1/4" high 
Dimensions: 14 1/16" wide x 5 1/2" deep 
Weight: 85 pounds 
Screen 19" diagonal measure 
Size: 186 sq. inch Screen area 
4x3 aspect ratio 
Display 120 sq. inches 
Area: (12.0" wide x 10.0" high) 
Character 80 characters per line, 25 lines per page 
Format: Option 16: 80 characters per line, 
48 lines per page 
Character 64 ASCII Characters, 5x7 dot matrix 
Style: within a 6x8 dot pattern 


Option 03: 32 Graphic Characters, 6x8 dot matrix 
Option 17: 64 Graphic Characters, 6x8 dot matrix 


Standard Interface 
Standard I/O Ports 


The standard Intecolor 8001 has two input ports. 

One port, Jl, is an asynchronous serial RS 232C I/O, or if Option 
O7 is installed, a serial 20 ma current loop I/O. The other port, J2, 
accepts parallel input data from the keyboard and provides an 8 bit parallel 
output. The Intecolor® 8001 is furnished with a crystal clock and provides 
a keyboard selectable baud rate of normal 110, 150, 300, 1200, 2400, 4800, 
and 9600 baud, or a high speed option of 880, 1200, 2400, 9600, 19,200, 
38,400, and 76,800 baud. 


The serial input port is furnished without parity checking so 
that when in the Plot Mode, or CCI Mode, eight data bits can be received. 


The signals for the standard RS 232C I/O ports are shown on 
page 3 and on Jl and J2 in Appendix A7. 


Pin 2 of the Keyboard J2 connector signals the Data communications 
equipment that the terminal has received a byte and is processing the last 
byte received. The Unit's input port has a one byte buffer. So for maximum 
speed, the communications equipment can send the next byte as soon as it 
has detected the high to low transition on pin 2. The wave form is shown 
below: 


32 OV. Approx. 70 MICRO SECONDS 


Next byte may be sent after high 
to low transition. 


Pin # Signal Line Nomenclature Direction 


1 Protective Ground AA NA 
2 Transmitted Data BA From ISC to DCE* 
3 Received Data BB From DCE* to ISC 
4 Request to Send CA From ISC to DCE* 
5 Clear to Send CB From DCE* to ISC 
7 Signal Ground AB NA 
20 Data Terminal Ready CD From ISC to DCE* 


*DCE - Data Communication Equipment 


RS232C INTERFACE 


Comments 


Connect to Chassis Ground and 
Pin 7 also 


"1" = Mark= -V 
"QO" = Space= +V 


"1" = Mark= -V 
"QO" = Space= +V 


Conditions the DCE* for Transmission 
Always +V if terminal is on 


Not required by ISC 


Connected to Pin 1 also 


Signals the DCE* that the data 
terminal is ready to transmit 
ON=+V=Ready 

OFF=-V=Not Ready 


START-UP AND INITIALIZATION 
Introduction 


BEFORE ATTEMTPING TO OPERATE YOUR InrECOLOR® g001, IT IS 
SUGGESTED THAT THIS SECTION BE READ AND UNDERSTOOD. The power switch 
(SW1) is located in the lower rear panel portion of the CRT case. Also 
located on this panel are the various input and output port connections. 
These are shown in Appendix A8. Connection diagrams are shown in Appendix 
A7. 


Power 


Plug the line cord into a 120VAC-60HZ outlet (230VAC-50-60 HZ 
with Option 11). When the power switch is pushed up the terminal is 
in the operating state. After the switch is turned on, a 60 second warm 
up period is required before operating the terminal. The unit will come 


up in the initialized state, So: 


Initialized State - So 


The unit will always come up in the initialized state-S, when 
power is turned on after being off for at least 30 seconds. 


In State So the following conditions are true: 


white 
black 


A. Visible foreground color 
Visible background color 
Reverse field flag = "Oo" 
Visible A7 bit = "0" (unless otherwise noted) 

Plot Bit = "oO" 

Page Mode Operation (unless otherwise noted) 

Terminal Mode = Local (unless otherwise noted) 

Baud Rate = 9600 with one stop bit (unless otherwise noted) 
Write left to right with visible cursor 

Blind foreground color = red 

Blind background color = black 

Blind A7 Bit = "Oo" 

Blind Plot Bit = "Oo" 

Blind Cursor at home or top left corner of screen. 


2 S0AGQGHMOAMAOAW 


After the above conditions have been set, the cursor is moved 
to the home position which is the top left hand corner of the screen, and 
the position of the first character of the first line. The screen will 
clear by an Erase Page command which effectively makes all 2000 (3840 with 
80 character x 48 line option) characters; spaces (20 HEX) which are white, non- 
blinking (97 HEX). The unit is now ready to accept commands from the keyboard 
or the serial input if connected. 


Convergence and Purity 
The units convergence and purity may need adjusting when initially 
received. Allow at least a 30 minute warm before setting the final convergence. 


See Appendix C for convergence alignment. 
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SUMMARY OF CONTROL CODES 
FOR INTECOLOR 8001 


NULL (control @) has no effect. 
PROTECT (control A) has no effect. 
PLOT (control B) enters graphic plot mode (see plot submodes). 


CURSOR XY (control C) enters X-Y cursor address mode for either 
visible cursor or blind cursor. 


FREE (control D) not used - has no effect. 
FREE (control E) not used - has no effect. 


CCI (control F) the next character which follows provides the 8 bit 
visible status word. 


BELL (control G) provides a 150 ms tone. 
HOME (control H) moves the cursor to top left corner of display. 


TAB (control I) causes cursor to advance to next column - the tab 
columns are every 8 characters. 


LINE FEED (control J) causes the cursor to move down one line. 


ERASE LINE (control K) causes the cursor to return to beginning of line 
and causes the complete line to be erased. 


ERASE PAGE (control L) causes the complete screen to be erased and 
the cursor moves to the home position. 


RETURN (control M) causes the cursor to move to the beginning of the 
line it presently is on. 


A7 ON (control N) turns the A7 bit flag on. 


BLINK/A7 OFF (control O) turns the blink bit and A7 bit off. 


BLACK KEY (control P) sets either foreground or background to color black. 


RED KEY (control Q) sets either foreground or background to color red. 


GREEN KEY (control R) sets either foreground or background to color green. 


YELLOW KEY (control S) sets either foreground or background to color yellow. 


BLUE KEY (control T) sets either foreground or background to color blue. 


VIOLET KEY (control U) sets either foreground or background to color violet. 
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CYAN KEY (control V) sets either foreground or background to color cyan. 
WHITE KEY (control W) sets either foreground or background to color white. 
XMIT (control X) causes data to be transmitted from the visible cursor 
to the end of page or until FF/OO is found in Refresh 
RAM. 
CURSOR RIGHT (control Y) causes the cursor to move right 1 position. 


CURSOR LEFT (control Z) causes the cursor to move left 1 position. 


ESC (control L ) provides an entry to the escape code table- must be 
followed by one or more codes for proper operation. 


CURSOR UP (control \ ) causes the cursor to move up one line. 
FG ON/FLAG OFF (control—] ) sets the flag bit off. 
BG ON/FLAG ON (control /\) sets the flag bit on. 


BLINK ON (control — ) sets the blink bit on. 


SUMMARY OF ESCAPE CODES 


FOR INTECOLOR 8001 


5 BIT CODE LETTER | FUNCTION 
O @ Visible cursor mode 
1 A Blind cursor mode 
- 2 B Plot via color pad 
3 , 1€ Transmit cursor X,Y position 
4 | D Not used 
*- ‘5 E. Re-entry to BASIC 8001 
6 F Sets full Sapien mode 
7 G Not used 
8 H Sets half duplex mode 
9 T : Not used 
LO J ‘eee write vertical mode 
11 | K Sets roll up and write left to right mode 
12: L Sets local mode 
13 M Not used 
14 N Not used 
m5 O Re-entry to the CPU operating system 
= 16 P Initializes and transfers control to 


the CPU operating system 


= ey fe) Character insert mode 
18 R Baud rate selection mode | 

A7 on = 1 stop bit, A7 off = 2 stop bit 

* 19 S Transfer control to the 8080 assembler 

* 20 T Transfer control to the text editor 

= OF : U Insert one line 

m. o29 | Vv Delete one line 

= 93 W Initializes and transfers control to 
BASIC 8001 


5 BIT CODE LETTER FUNCTION 


24 X Sets page mode and write left to right 
mode 

25 Y Test mode - fill page with next character 

26 Z Set write seus on 45 degree mode 

a7 [ Not used 

28 \ Sets write up on 45 degree mode 

29 _| Set unit up for Block receive mode 

30 N Causes a jump to address 9FAQ@H 

31 — Transfer control to the CRT mode 


* Must include certain option to be operational 


SUMMARY OF GRAPHIC PLOT SUBMODES 


FOR INTECOLOR 8001 


OPTIONAL 

RS-232 INPUT PLOT NORMAL KEY- FUNCTION 
CODE SUBMODE BOARD CODE KEYBOARD CODE 

255 Plot Mode Escape Control ? FES 
254 Charactor Plot Control => F 14 
253 X Point Plot Control = Pe oS 
252 Y Point Plot Control & F 12 
251 X-Y Incremental Point Plot Control ; Fil 
250 Xo of X Bar Graph Control : F 10 
249 Y of X Bar Graph Control 9 FS 
248 X max of X Bar Graph Control 8 F 8 
247 Incremental X Bar Graph Control 7 F 7 
246 Yo of Y Bar Graph Control 6 F 6 
245 X of Y Bar Graph Control 5 aes 
244 Y max of Y Bar Graph Control 4 F 4 
243 Incremental Y Bar Graph Control 3 F 3 
242 Xp Vector Plot — Control 2 <2 
241 Yo Vector Plot Control 1 Fol 
240 Incremental Vector Plot Control @ F @ 


SUMMARY OF INCREMENTAL DIRECTION CODES 
FOR INTECOLOR 8001 


Value 


CRT REFRESH MEMORY LAYOUT 


The 2000 [3840] * characters for display are stored in a 4096 
[8192 | word RAM memory beginning at 32,768 (8000 HEX) and ending at 
36,767 (8F9F HEX) [40,447 (9DFF HEX)] . The first word is the 
zero character stored as the A bit and then the 7 bit ASCII code 
(Ag to Aj). The second word is the compositestatus for this character. 
It 1s composed of Plot Character Bit (Ao), Foreground Blink (Ag), Back- 
ground color code (Ac, Ay, A3), and Foreground color code (A., Ai, Ao). 


Therefore, each screen character requires two 8 bit words in 
memory, (the screen character and the character's compositestatus). The 
RAM memory location 8FAO HEX [orag | to 8SFFF HEX [OrFrF HEX ] are used for 
scratch pad storages. Memory location 8FBO }orBo HEX] and SFB1 (9FB1 | 
are the locations of the Cursor character position and line number 
respectively. With the Roll Mode (Option 15) memory location SFB2 [9FB2 | 
provides the number of lines that the home position has been shifted or 
rolled. 


* [ Indicates value for 48 Line System| 


1A 
REFRESH MEMORY WORD FOR ONE CHARACTER 
EVEN : _ ODD = (EVEN +1) 
ASG It Code 
BLINK ; FOREGROUND | 
[BIT {}B G R | COLOR 


® 


secon B GR 
COLOR 


PLOT BITS PLOT 


LO 
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Keyboard 


The Intecolor 8001 has a detachable keyboard which presents 
the standard ASCII four level code. (See Appendix A-1 for keyboard layouts). 
The keyboard keys are optically encoded by means of phototransistors, a 
light source and shutters attached to the keys. There are no switches 
to wear out and the unit is RFI free. The Keyboard does not provide 
two key rollover. 


CPU Reset 


The CPU Reset key provides a reset signal to the 8080 CPU. 
Its primary function is to allow the operator to regain control of the 
terminal if the software the customer has installed gets hung in an 
endless loop. If the reset is operated properly the bell will issue a 
short beep upon the release of the key. If automatically forces the 
terminal to the S, state. That is, just as if the power had been turned 
off and then back on. If additional RAM memory is installed this memory 
area is not cleared, but the scratch RAM area within the CRT Refresh RAM 
card is cleared. 


Control Key 


The control key must be held down while the proper alpha numeric key 
is depressed if a control function is desired. The control functions are either 
color coded or have its desired results engraved on top of the key. Those keys 
which have a name enclosed within a ( ) parentheses indicate that they are also 
Standarized escape codes. The escape codes only require that. the ESC key 
be depressed then the ( ) parentheses key desired, 


Shift Key 
The shift key must be held down while the proper alpha numeric key 
is depressed if a shifted function is desired. Note that both the control and 


shift key must be held down to generate certain codes from the keyboard using 
the alpha numeric keys. See Appendix A-2 for the keyboard code set. 
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DETAIL OF CONTROL CODES 


All of the display commands can be entered either through the 
serial input port or the keyboard. The keyboard input port has the highest 
priority of all inputs or outputs. The eight bit Intecolor 8001 code 
set as shown in Appendix A-2 must be used for the serial input port. The display 
control commands are a subset of the 32 ASCII control code set, and a flow 
diagram of these commands is shown in Appendix A-3. 


With some display commands, such as the Graphic Plot Mode, 
delays may be experienced at the higher baud rates. A chart for these 
delays is shown in Appendix A4. 


The Intecolor 8001 display commands has been expanded by 
an additional 32 commands via the ESC, character sequence as shown in 
Appendix 5. The terminal employs two input pointer flags, one for the 
keyboard and one for the RS232C input. Each flag may point to a 
different Mode of operation and thus the terminal can act differently 
from the keyboard as compared to the RS232 input. (See blind cursor 
operation Code 1 on page 19 .) 


Code @ Null - (Control @) 
Has no effect upon the display 
Code 1 Protect - (Control A) 


Not presently implemented so it has no effect upon the 
unit. 


Code 2 Graphic Plot Mode —- (Control B) - (Option 02) 


The general Graphic Plot Mode is entered by a 
binary code 2 or a Control Code B. (See Appendix B). It should be 
noted that the XY Plot Mode is also entered at the same time. Ifa 
plot mode other than XY Point Plot is desired, the next word that follows 
Should then be a binary code from 240 to 255. These codes represent 
the various plot submodes as shown in the summary of Graphic Plot Submodes. 


An additional feature is available to allow a graphic plot to 
be erased by simply setting the Flag bit on before entering the plot mode. 
This causes an XOR function to exist when plotting. Therefore, if you 
plot the same point, bar or vector twice, the second time erases the 
original. 


Once in the general Plot Mode, any of the plot submodes 
may be entered by sending the corresponding code to the terminal. When 
this code is received, a flag internal to the terminal, known as PLOFL, 
is set placing the terminal in the appropriate plot submode. It should 
be noted that in many of the plot submodes, PLOFL is automatically set to 
a different value upon completion of the operation of that submode causing 
the terminal to enter a new submode. This is done to make coding and 
operation of the terminal in the various plot functions easier for the 
operator. The various submodes and their interactions are explained in 
detail in Appendix B. 
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Code 3 Cursor X-Y (Control C) 


The visible cursor may be positioned any where on the 
screen simply by sending a 3-word sequence beginning with 03. The 
next two words that follow determine that X character position (0-79) 
and Y line position (0-24) for 25 line unit or [0-47] for 48 line unit. 
Both X and Y values must be in binary form with the range indicated. 
The cursor home position (i.e., the top left hand corner) is position O, O 
while the bottom right hand corner is (79, 24) or (79, a7) . 


If the cursor is positioned at X = 80 binary (50 HEX) then the cursor will 
disappear. But if a character is typed it will be positioned at the 
beginning of the line specified by Y + 1, the cursor then reappears in 
character position 1. Any cursor command will automatically force the 
cursor to reappear at the proper position in relation to character position 
O, line Y + 1. 


If the cursor X values is 81 binary (51 HEX) or larger then 
the CRT ignores this as the visible cursor X values and sends the 
unit into the blind cursor addressing mode. Once in the blind cursor 
X-Y addressing mode three (3) additional words must be sent. They are 
blind cursor X value, blind cursor Y value, and the blind status word. 
The blind X value must be in the_range of 0-79 and the blind Y value 
must be in the range of 0-24 or [0-47] : The blind status word must 
be in the same format as required in the CCI mode (control F). See the next 


page, 


The blind A7 bit will be set on by sending from 128 binary to 
255 binary instead of 81 binary when going from the visible cursor 
X,Y mode to the blind cursor X,Y mede. The Blind A7 bit will be set off 
anytime a binary number between 81 and 127 is used to get into the blind 
X,Y mode. 


It should be noted that_the X and Y cursor values received 
are masked to 0-127 and 0-31 fo-63] respectively. Then, if the value is 
still out of range, the X¥ value has 80 subtracted and the Y values has 25 
[48] subtracted. 


When exiting from the blind cursor X-Y mode the terminal is 
left in the blind cursor mode for what ever input device caused the 
mode to be entered. That is if after CPU reset is operated the keyboard 
causes the blind cursor XY to be addressed then the keyboard will be 
left in the blind cursor mode while the RS232 serial is still in the 
visible cursor mode. 


Code 4 EOT - (Control D) 


Has no effect upon the display 


Code 5 ENQ - (Control E) 


Has no effect upon the display 


iis 


Code 6 CCI - (Control F) 


When this code is received the system accepts the next 
eight bit word from the serial input as the new compositestatus for the 
characters which follow. See CRT Refresh Memory Section. 


The first three bits represents the Foreground Color with 
Red ppAg: Green,= Al, and Blue =A, The next three bits represent the 
Background Color (optional) with RedpeA3, Greenp=Aqg, and Bluep=A,;. The next 
bit, Ag is the Blink bit for the Foreground Color and the last bit, Aj is Plot 
Character bit which causes the display to interpret the ASCII word as a 2x4 plot 
array. 


Code 7 Bell - (Control G) 


When this code is received a tone will sound for about 150 MS. 


Code 8 Home — (Control H) 


When this code is received the cursor moves to 0,0 or the 
top left hand corner of the Screen. 


Code 9 Tab - (Control I) 


When this code is received the cursor moves horizontally 
to the next tab position. The tab positions are fixed and are at 
every eight positions from zero. 


Code 10 Line Feed - (Control J) 


When this code is received the cursor moves down one line. 
This is the only code used for cursor down. 


Code ll Erase Line —-— (Control XK) 


When this code is received a carriage return is initiated and 
the characters from the beginning to the end of the line are replaced with 
spaces and have the same color and status as the present visible CCI 
status. The cursor is always positioned at the beginning of the line. 


Code 12 Erase Page - (Control L) 


When this code is received the complete screen is replaced 
with spaces that have the same color and composite status as the present 
visible CCI status. The cursor always returns to the Home position. The blind 
cursor is also positioned at home. 7 


Code 13 Carriage Return. - (Control M) 


When this code is received, the cursor returns to the beginning 
of the line that it presently is on. 
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Code 14 Ay On: <= (Control N) 


Upon receiving this code, the characters which are to be 


displayed have A, forced to a "1". 
character sizes for 48 line units. 


displayable character types from 128 to 256. 


Code 15 Blink - AJ - OFF - 


This bit is used to allow 2X 
This effectively doubles the number of 


(Control O) 


When this code is received the characters which follow have 
A> set to "0" (i.e., opposite to Ay On as above) and also have the 
Blink bit, Ag of the composite status for the character set to "0" 
(i.e., the opposite of Blink-On per Code 31.) 


Code 16 to 23 or Color Keys - There are eight color keys 
A> Ay Ay 
Black (Control P) Code 16 O O O 
Red (Control Q) Code 17 O O 1 
Green (Control R) Code 18 O 1 O 
Yellow (Control S) Code 19 O- 1 
Blue (Control T) Code 20 1 0 O 
Magenta (Control. U) Code 21 1 0 iL 
Cyan (Control V) Code 22 1 1 O 
White (Control W) Code 23 1 1 a. 


When one of these eight codes is received then one of two 
things happens, depending upon the Flag bit. 
the key that is depressed will change the compositestatus to that 


Foreground Color code. 


If the Flag is off then 


If the Flag is on, then the key that is depressed will change 
the compositestatus to the Background Color code. If Background 
Color option is used, then it will display that color. If Background Color 
option is not supplied, then no effect will be noticed. 


| Note that when the plot via color pad is selected, one of the eight color 
select keys will select one of the eight plot blocks. The plot option 2 is installed 
See Escape B section for details. 


Code 24 Transmit - 


(Control X) 


Whenever control X is received the terminal starts transmission 
from the visible cursor present position to the end of the screen, or 
until it detects a FF, YY Hex sequence in the Refresh memory. 


The transmission sequence is terminated by a carriage return, 
elther @D Hex or 8D Hex at the customer option. It should be noted that 
there may be many @D Hex or 8D Hex imbedded in the data transmission 
Since these are legal words in the refresh memory. 
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The transmission sends each 8 bit word in memory in 
Sequence. That sequence is the ASCII character, then the status of that 
character, followed by the next ASCII character and then its status until 
the FF, @@ sequence is detected. 


The best way to have this data sent back to the terminal 
is via the ESC} or block receive mode. 
Code 25 Cursor Right - (Control Y) 
Moves the cursor right one character without destroying 
any information. 
Code 26 Cursor Left - (Control Z) 


Moves the cursor left one character without destroying 
any information. 


Code 27 Escape —- (Control |) 


The Escape command effectively expands the control code 
set by 32 additional code capabilities. This requires at least a two 
code sequence (ESC, letter) which then performs a given function. At 
present only 26 of the 32 additional command capabilities have been 
enabled. These commands are given in the following table. (For Detail see 
the Escape Code Section). 


SEE ESCAPE CODE TABLE —- Page 17 
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ESCAPE CODE TABLE 


DECIMAL 
OPTIONS CODE LETTER FUNCTION 
0 @ Visible Cursor Operation 
1 A Blind Cursor Operation 
i 2 B Plot Via Color Pad 
3 C Transmit Cursor X,Y Position 
4 D Not Used 
ss 5 E Re-Entry Control to BASIC 8001 system 
6 F Sets Unit to Full Duplex 
7 G Not Used 
8 H Sets Unit to Half Duplex 
9 a Not Used 
1 J Sets Unit to Write Vertical 
* he K Sets Unit to Roll up Mode & write Left to Right 
12 L Sets Unit to Local Mode 
13 M Not Used 
14 N Not Used 
15 O Re-Entry control to the CPU Operating System 
* 16 P Initializing & Transfers Control to the CPU 
Operating System 
iy QO Allows Operation in Character Insert Mode 
18 R Allows Selection of 1 of 7 Baud Rates 
= 19 S Transfers Control to the 8080 Assembler 
= 20 T Transfers Control to the Text Editor 
* 21 U Inserts one line (80 blanks) 
* 22 V Deletes one line (80 blanks) 
rs 23 W Transfers Control to BASIC 8001 Software 
24 X Sets Unit to Write Left to Right & Page Mode 
25 4 Test Mode-Fills Screen with Next Character 
26 Z Sets Unit to Write Down on 45 Degrees 
27 [_ (ESC) Not Used 
28 ™ Sets Unit to Write Up on 45 Degrees 
29 ~j Sets Unit to Block Receive Mode 
30 /N Causes a Jump to Ram Address 9FAQ@H 
31 — Transfers Control to the CRT Mode 
The letters are presented for easy reference; i.e., (full 


duplex mode requires ESC, F sequence). It should be noted that the Escape 
control codes can be any 8 bit value so long as the 5 least significant 

bits are correct for the operation desired. The terminal simply masks off 

the undesired higher order bits. The Keyboard and RS232C input port has 
separate and independent Flags which determine some of the CRT modes. 
Therefore, the Keyboard may be in the character input mode while the RS232 
input may be in the Plot mode or vise versa. The input port and the Keyboard 
can operate completely independently of each other. See Details of Escape Codes 
section for more information. | 
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Code 28 Cursor Up - (Control \, ) 


Moves the cursor up one line without destroying any 
information. This is effectively the opposite of a Line Feed operation. 


Code 29 Flag Off - (Control_) 


When this code is received the Reverse Field flag is 
set to "0". Effects the special character codes (96 to 127) and the 
color codes (16 to 23). 


Code 30 Flag On - (ControlA) 


When this code is received the Reverse Field flag is 
set to one. Effects the special character codes (96 to 127) ; the color 
codes (16 to 23); and the plot modes. 


Code 31 Blink On. = (Control _ ) 


When this code is received the Blink bit Ac of the 
composite status is set toa "1". 


This bit is turned off when the Blink-Protect-Off key 
is operated (see Code 15 ). 


Code 32 to 95 - Numbers and Letters 


These provide the standard printing ASCII Upper Case 
characters, punctuations and numbers. See Appendix A-2 for code set of the 
the Intecolor 8001. 


Code 96 to 127 - Special Characters 


These codes provide either 32 special characters (such as 
lower case ASCII characters) or 64 special characters. The 64 special characters 
are actually two groups of 32 special characters. A group is selected depending 
upon the condition of the Flag bit. If the flag bit is off then the codes are not 
changed when they are placed in the CRT refresh RAM. If the flag bit is on then 
these codes have 96 subtracted from them before they are replaced in the CRT 
refresh RAM. Therefore they are mapped into O to 31 within the CRT refresh memory. 
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DETAILS OF ESCAPE CODES 


@ or Code 0 —- Visible Cursor Mode 


This is the terminal's normal mode of operation and 
it is also the startup state. A received character is placed at the visible cursor 
location. The cursor then advances to the right one position awaiting the 
next character. All normal cursor operations are applicable to placing 
the cursor at a different location. 


A or Code 1 -—- Blind Cursor Mode 


This optional mode provides for a dual cursor operation. 
That is, normally the host computer will operate in the blind cursor 
mode and the keyboard in the visible cursor mode. The two modes will 
not interact with each other. There is also a blind status which may be 
different than the visible status. The only blind cursor movements allowed are 
a subset of the cursor X-Y positioning. See Code 3 or control C. This mode 
allows operation without delay for ASCII TEXT at rates up to 38.4 K Baud. 


B or Code 2 - Character Plot Via Color Pad 


When the plot option is installed then this plot mode 
will be available. It will normally be used via the color pad, but can 
be used without it. It provides a mix between the Plot Mode and the normal 
ASCII Character Mode. Instead of responding as described in 
Character Plot, this mode uses only eight codes to intensify each of the 
eight blocks within a character. These intensifying codes are the normal 
color select codes (Control P through W). 


This option normally uses the color select pad on the keyboard. 
The pad 1s arranged as shown below. 


a , 


Yellow 


Color Selection One 
Pad Character Plot 
Aray 


One Plot Block Selected by Green 


Piqure- 2.526. 
Lo 


From the above it is easy to see the one to one 
correspondence between the 2x4 color select pad and the 2x4 character 
plot blocks. Thus, this mode is designed especially for use by the 
keyboard to simplify the drawing of graphs or the correcting of graphs. 
Once in this mode a block at the top right hand corner of the cursor 
present position can be intensified by pushing the top right hand corner 
key in the color select pad, (in this case the blue key or Control T or 
Code 20). Once that plot block has been intensified, any other plot 
block at that same character location can also be intensified since the 
cursor does not automatically advance. If the blue key was to be pushed 
the second time, then the already intensified plot block will be 
extinguished. This effectively allows any one plot block to be erased. 
After all desired plot blocks have been either intensified or extinguished, 
the cursor may be conventionally moved without escaping from this 
special text and character plot mode. In fact, all of the control codes 
are effective while in this mode except the color select control codes, 
and any of the ASCII Text characters can be entered and displayed. Any 
code that requires a two key or more Sequence (such as cursor X-Y, CCI, 
and ESC) will terminate the mode. It should be noted that the ASCII 
Character when entered and displayed advances the cursor as previously 
done in the visible mode, but the plot blocks (generated by the color 
pad) do not advance the cursor. Therefore, when a character position has 
been used to display plot blocks a cursor command must be given to 
advance the cursor to the next character position. 


C or Code 3 - Transmit Cursor X,Y 


When this code is selected the terminal sends out the 
following 7 word sequence: 


O3, X, Y, O06, Status, ASCII Character, CR. 


The X and Y values represents the cursor position on the screen. The 
status is the status of the ASCII character at that cursor location. The 
CR may be either a @D or an 8D HEX at the customer request. 


This sequence of transmission is the same that the light pen 
would provide if the unit is so equipped. 


E or Code 5 - Re-Entry to BASIC 8001 


Return to BASIC 8001 without destroying the BASIC 8001 
source program which is in Ram memory. 


F or Code 6 - Full Duplex Mode 


When this mode is selected then the Keyboard characters 
are only sent to the RS232C serial port. They are not processed by the 
terminal. Therefore, once the unit is put in the full duplex mode via 
the keyboard, then the only "normal" way the mode can be changed to 
local or half duplex is via the RS232C serial port. There are two other 
ways that have been provided to regain local control. One way is to 
operate the CPU Reset key on the Keyboard, which will initialize the 
terminal as if power has been just turned on. The other way is to 
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operate the break key on the keyboard. When this is done a break of 150 MS 
will be transmitted on the RS232C serial port, and the terminal will be 
forced into the half duplex mode. 


H or Code 8 - Half Duplex Mode 


When this mode is selected then the keyboard 
characters are not only processed by the terminal but are also sent to the 
RS232C serial port. 


J or Code 10 - Write Vertical Mode 


This effects the visible cursor mode only and causes 
the terminal to enter characters vertically one below the other. All 
other cursor movements are possible via the cursor mode. After a character 
is entered the cursor is moved down one character awaiting the next 
character. Upon reaching the last line the next character will be on 
the top line, i.e. wrap around occurs. 


K or Code 11 - Roll Mode (option 15) Write left to right 


When this mode is selected the terminal will cause a page roll 
up when the last line has been filled. Al148 line units roll two lines at a time 
while 25 line units roll only one line. Note the plot mode and blind cursor mode 
only work in non-roll mode. This mode also sets the visible cursor to write left to 
right. 
L or Code 12 - Local Mode 


When this mode is selected then the keyboard characters 
are displayed on the terminal, but they are not sent tothe RS232C serial 
port. In this mode the RS232C serial input port can receive data or change 
this mode. The terminal can be made to transmit out of the RS232C port, 
while in the local modeby typing Control X or ESC C. 


QO or Code 15 - Re-Entry to CPU Operating System Mode 


Causes the same result as Code 16 below but does not 
reinitialize the I/O Byte or the second RS232C channel Baud rate. 


P or Code 16 - Initialize CPU Operating System Mode 


When this optional mode is selected the terminal enters 
into the CPU Operating System. It then obeys all the commands that 
are allowed in the CPU Operating System. See the CPU Operating System Manual. 


Q or Code 17 - Character Insert Mode 


Once in this mode the CRT acts exactly like the normal 
visible cursor system for all control commands except for those requiring 
a 2 or more character sequence (such as Cursor XY, CCI, and ESC). 
When any character is typed or received via the RS232C input, it is inserted 
within the line at the cursor present position and every character 
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after the cursor to the end of the line is shifted right one character 
position. The last character on the line is lost forever. The cursor 

is also advanced one position. The above is trvweexcept for control codes, 
and "Delete" or (shift ' _') keys (code 127). 


When the "delete" key is depressed or code 127 is 
received via the RS232 input port then the character at the cursor present 
position is deleted and all characters to the end of the line are 
shifted left one character position. The last character on the line 
becomes a space. The cursor does not advance. 


When the "ESC" key is depressed then the character 
insert-delete mode is terminated after the second character is selected. The 
terminal then normally returns to the visible character mode. 


R or Code 18 - Baud Rate Selection Mode 


When this mode is entered the unit then accepts the 
next character as one of seven baud rates. It does this by looking at 
only the first three bits. Therefore, any 8 bit character that has the 
desired 3 lower order bits will do. Normally the keyboard numbers 1 to 
7 are used. The baud rates and the corresponding numbers are indicated in 
the table below: ~ we a a 


Normal Baud 
Rate 


Guna la — ~ [ 
880 1200 2400 9600 19,200 38,400 |76,800 


The unit is initialized with power up at normally 9600 
baud, with one stop bit. This initialized baud rate can be specified by 
the customer at any of the fourteen above rates when ordered. It 
Should be noted that only in certain modes (blind cursor mode) can the 
38,400 Baud be used with delays. In no case can 76,800 Baud be used 
without delays. The unit may be ordered with either normal baud rates 


or with the High Speed Baud rates. The two different rate systems cannot 
be mixed. 


High Speed 
Baud Rate 


The number of stop bits will be determined when the baud rate 
is set by the condition of the A7 flag. If A7 was on before the rate is selected, 


l stop bit is selected; if A7 was off before the rate is selected 2 stop bits 
are selected. 


S or Code 19 - 8080 Assembler Mode 


When this optional mode is selected the terminal enters 
into the 8080 Assembler Mode. It then obeys all the commands that are 
allowed in the 8080 Assembler. At present this option is not available. 
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T or Code 20 - Text Editor Mode 


When this optional mode is selected the terminal enters 
into the Text Editor Mode. It then obeys all the commands that are 
allowed in the Text Editor. At present this option is not available. 


U or Code 21 - Insert Line Mode 


When this mode is selected the cursor moves to the 
beginning of the line it is presently on and this line and all lines to 
the end of the page is shifted down by one line. Then a new line 
of 80 spaces ( or blanks) are inserted with the cursor 
remaining at the beginning of that new line. 


Normally the cursor will be at the beginning of the 
line to be inserted when this mode is used. After a line has been inserted 
the terminal returns to the normal visible character mode. 


V or Code 22 —- Delete Line Mode 


When this mode is selected the cursor moves to the 
beginning of the line it is presently on and this line is deleted. All 
lines to the end of the page are shifted up by one line. Then a new 
line of 80 spaces ( or blanks) are inserted at the bottom of the page. 

The cursor will remain at the beginning of the line that had been deleted. 
After a line has been deleted the terminal returns to the normal visible 
character mode. 


W or Code 23 - BASIC 8001 Language Mode 


When this optional mode is selected the terminal enters 


into the BASIC 8001 Language mode. It then obeys all the commands that 
are allowed in Basic 8001. See the "BASIC 8001 Manual". 


X or Code 24 - Page Mode Write Left to Right 


When this mode is selected the terminal will not roll 
up when the last line has been filled, but will begin at home again. The 
terminal is also placed in the write left to right mode. This is the 
normal power up mode. This mode affects all modes that use the visible 
cursor. The blind cursor and plot modes will only operate in the page mode. 


Y or Code 25 - TEST Mode 
When this mode is selected the next character that follows 


causes the complete screen to be filled with that character. Note use ESC, 
Mig ds: for a convergence test pattern. 
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Zor Code 26 - Write Down 45 Mode 


When this mode is selected the terminal will place 
the character at the present visible cursor and will then cause a cursor | 
right followed by a line feed to occur. Therefore, the next character 
entered will be to the right and down one position from the previous 
character. When the bottom of the page is reached the next character 
will appear on the top of the screen, i.e., wrap around occurs. 


C or ESC or Code 27 - No Effect Code 


Performs a return to visible character mode. 


\N or Code 28 - Write Up 45 Mode 


When this mode is selected the terminal will place the 
character at the present visible cursor and will then cause a cursor right 
followed by a cursor up to occur. Therefore, the next character entered 
will be to the right and up one position from the previous characters. 
When the top of the page is reached the next character will appear on 
the bottom of the screen, i.e., wrap around occurs. 


— or Code 29 - Block Receive Mode 


Causes the unit to enter into the block receive mode. 
Uses the blind cursor to position the data. Looks for a (FF), (00) 

HEX sequence to terminate back to the visible cursor mode. Note this 

is same format as when control (x) or page transmit is requested. Note 
page transmit starts at visible cursor and ends at end of page or when 
an (FF), (00) HEX sequence is found. 


~/\ or Code 30 - Jump to RAM 9FAGH 
When this code is received the CRT 0.S. branches to 
location 9FAYH. Therefore, the user must patch into RAM address 9FAQH 
a jump to his program. 
— or Code 31 - Transfers Control to the CRT Operating System 
When this code is received, the unit is forced to the 
CRT 0.S. mode. If Option 34, the CPU O.S., is also installed, then a 
message will be printed saying: an | 


YOU ARE NOW IN THE 8001 CRT MODE 
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DETAIL OF GRAPHIC PLOT SUBMODES 


Code 2 Graphic Plot Mode - (Control B) - (Option 02) 


The general Graphic Plot Mode is entered by a 
binary code 2 or a Control Code B. (See Appendix B). It should be 
noted that the XY Plot Mode is also entered at the same time. If a 
plot mode other than XY Point Plot is desired, the next word that follows 
should then be a binary code from 240 to 255. These codes represent 
the various plot submodes as shown in the summary of Graphic Plot Submodes. 


An additional feature is available to allow a graphic plot to 
be erased by simply setting the Flag bit on before entering the plot mode. 
This causes an XOR function to exist when plotting. Therefore, if you 
plot the same point, bar or vector twice, the second time erases the 
original. 


Once in the general Plot Mode, any of the plot submodes 
may be entered by sending the corresponding code to the terminal. When 
this code is received, a flag internal to the terminal, known as PLOFL, 
is set placing the terminal in the appropriate plot submode.: It should 
be noted that in many of the plot submodes, PLOFL is automatically set to 
a different value upon completion of the operation of that submode causing 
the terminal to enter a new submode. This is done to make coding and 
operation of the terminal in the various plot functions easier for the 
operator. The various submodes and their interactions are explained in 
detail in Appendix B. 


In addition to being able to enter the plot submodes 


from the general Plot Mode, any plot submode may be entered from any other 
plot submode with the exception of the Character Plot Mode. 
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Colors may be defined on a character by character basis only 
and the color of an individual plot block as well as all other intensified 
plot blocks within a character will be the most recent color defined when 
a new block is intensified in that character. To change a color, it is 
required that the Plot Mode or plot submode be terminated, the color 
changed, and the Plot Mode be re-entered. 


The character grid is made up of 80 characters wide by 25 [as] 
lines high. The O reference point for all plotting is always the lower 
left corner. Each character is further broken up into 2 blocks wide 
by 4 blocks high which then causes the plot grid to be 160 blocks 
wide by 100 [192] blocks high. All plot submodes operate on this size grid 
and have the same reference point. Positive direction 1S considered up 
and to the right and negative direction is considered down and to the left. 


All plot submodes and the general Plot Mode are terminated 
or exited by the binary code, 255. Whenever this code is received, 
the modes are terminated and must be re-entered as described above. 


| Appendix B-2 gives a convenient summary of the codes 
required to enter the Plot Mode and the various plot submodes as well as 
the status of PLOFL before and after each operation and the ranges of each 
operation. 


Plot Mode - Escape - (255 binary) 


7 This code is used to exit from the Plot Mode or any 
of the plot submodes. The control "?"or F15 is used to escape from 
the Plot Mode from the Keyboard. 


Character Plot - (254 binary) 


The Character Plot is entered by a 254 after the general 
Plot Mode, "2" or Control Code B, is entered. From the Keyboard use 
Control "#»" or F14. It may also be entered directly from any of the 
other plot submodes. After entering the Character Plot, the next word 
will be treated as a plot character except for code 255 binary or (FF) 
hexadecimal (i.e. all eight bits are "l's"). See Appendix B- 


The general Plot Mode and the Character Plot terminate 
upon receipt of a 255 code. The above procedure must be repeated after 
a 255 code terminates the Plot Mode and the plot submodes. 


Other plot submodes may not be entered from the Character 
Plot. To enter other plot submodes, the Character Plot must be terminated, 
the general Plot Mode entered and the plot submode entered with its associated 
code. 
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The procedures for entering and exiting the Character 
Plot are shown below. 


Function Code 
Plot Mode 2 
Character Plot 254 
Plot Character 1 O to 254 
Plot Character n O to 254 
Plot Escape 255 


The Character Plot causes the 6 wide by 8 high dot 
matrix to be divided into 8 blocks organized 2 blocks wide by 4 blocks 
high. Each block consists of a sub-dot matrix of 3 dots wide by 2 dots 
high. Each block may be individually intensified by defining the bit 
(one of eight bits) associated with the block in the plot character. 
Bits may by "ORed" together for a combination of blocks in a plot character, 
creating a form of graphics for plotting data or drawing diagrams. 
Large characters may also be created by utilizing the blocks of several 
character positions to create a large 5x7 dot matrix. 


X Point Plot - (binary 253) 


The X Point Plot is automatically entered upon receipt 
of the general Plot Mode code, binary code 2, or Control Code B. It 
also may be entered directly from any of the other plot submodes except 
Character Plot. From the Keyboard use Control "=" or F13. After 
entering the X Point Plot, the next word defines the X value 
of the block that is desired to be plotted See Appendix B- 
The X value in this mode may range from binary 0 to 159 and all other 
values will cause 160 to be subtracted and the resultant value of X to 
be computed. | 


The X Point Plot may be terminated by code 255 which 
causes the general Plot Mode to be terminated also. Any of the other plo 
submodes may be entered directly from the X Point Plot by simply entering 
the appropriate plot submode codes which range from binary 240 to 254. 


It should be noted that this mode does not cause a 
block to be intensified, but only causes the X value to be defined. Once 
the X value is sent, the terminal is automatically placed in the Y Point 
Plot mode. Thus, the next code sent will be the Y value, which may range 
from binary O to 99 fo-191]. Upon receipt of the Y value, a plot block 
will be intensified on the CRT screen at the X value and Y value intersection. 
The terminal is then automatically placed in the X Point Plot mode and the 
next word sent will be interpreted as an X value. 


Therefore, once in the X Point Plot mode, new 


blocks may be defined by simply sending X values and Y values consecutively, 
without the necessity of re-entering the X or the Y Point Plot modes. 
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The procedures for entering and exiting the X Point Plot mode are shown 
below: 


Function Code 
Plot Mode* 2 
Xy Value O to 159 
Aa Value O to 99 (0-191) 
Xn Value O to 159 
ae Value O to 99 (0-191) 
Plot Escape 255 
or or 
Plot Submode 240 to 254 


* Automatically X Point Plot mode also 


NOTE: SEND Code 253 between X,Y data sets if necessary 
for timing considerations. See Appendix A-4 for delays. 


The X Point Plot in conjunction with the Y Point Plot 
allows any block on a 160 wide by 100 (192 for 48 Line) high block 
matrix to be positioned to and intensified. If the new block is within 
a character position that is a previously intensified ASCII character, then 
the ASCII character is replaced completely by the new block and its 
associated color. 


Y Point Plot - (binary 252) 


The Y Point Plot is entered by a binary 252 code 
after the general Plot Mode is entered. See Appendix B- 
From the Keyboard use Control " " or F12. It may also be entered 
directly from any of the other plot submodes except Character Plot 
(binary 254). It is more commonly entered automatically from the X 
Point Plot mode. After entering the Y Point Plot, the next word defines 
the Y value of the block that is desired to be plotted and causes the 
block to be intensified in accordance with the Section on (binary 253). The Y 
value in this mode may range from binary O to 99 (0-191) and all larger 
values will cause 100 (192) to be subtracted from the new value of Y to 
be calculated. 


Upon receipt of the Y value, the X Point Plot is 
automatically entered by the terminal. The X value of the next block to 
be plotted may then be sent as explained in the Section on (binary 253). 


The Y Point Plot is terminated by Code 255 which causes 
the general Plot Mode to be terminated also. Any of the other plot submodes 
may be entered directly from the Y Point Plot by simply entering the appropriate 
plot submode codes which range from binary 240 to 254. 
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| Therefore, once in the Y Point Plot mode, new points 
may be defined by simply sending X values and Y values consecutively 
without the necessity of re-entering the X or the Y Point Plot modes. The 
procedures for entering and exiting the Y Point Plot mode are shown below: 


Function Code 
Plot Mode 2 
Plot Submode 252 
Yy Value* O to 99 
X5 Value O to 159 
Y5 Value O to 99 
X, Value O to 159 
Yn Value O to 99 
Plot Excape 255 

or or 
Plot Submode 240 to 254 


* Plots point uSing whatever previous X 
Value left in memory. 


NOTE: Send Code 253 between X,Y data sets if necessary for 
timing considerations. See Appendix A-4 for Delays. 


XY Incremental Point Plot - (binary 251.) 


The XY Incremental Point Plot is entered by code 251 
after the general Plot Mode is entered. From the Keyboard use Control 
";" or Fll. It may also be entered directly from any of the other plot 
submodes, except Character Plot. After entering the XY Incremental Point 
Plot mode, the next word defines the next two increments as shown in 
Figure below. This word may have a range from binary 0 to 239 since binary 
240 to 255 is used for the plot submode codes. 


Block l Block 2 
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n+l ay 

0 O No Change 

d O Positive Increment 
O 1 Negative Increment 
a 1 No Change 


n= 0, 2, 4, 6 


ee bo through b3 are "O"s, then the plot block will 
not print but will increment one increment according to the coding of 
by through b7. This allows the user to easily "skip" a plot increment 
by plotting with an invisible block. 


It should be noted that the XY Incremental Plot mode 
does not automatically transfer the terminal to any other plot submode 
upon receipt of an incremental change word,but remains in the XY 
Incremental Plot mode ready to receive another incremental change word. 
Therefore, a series of incremental movements may be made by sending 
consecutive incremental change words. 


The XY Incremental Plot mode may be terminated by code 
255 which causes the general Plot Mode to be terminated also. Any of the 
other plot submodes may be entered directly from the XY Incremental Point Plot 


by simply entering the appropriate plot submode codes which range from binary 240 
to 254. 


The procedures for entering and exiting the XY 
Incremental plot mode are shown below: 


Function Code 
Plot Mode 2 
or or 
Plot Submode 240 to 253 
XY Incremental 
Point Plot 251 
Incremental Change 
Word 1 O to 239 


Incremental Change 


Word n O to 239 
Plot Escape 205 

or or 
Plot Submode 240 to 254 


NOTE: Send code 251 between XY incremental point words 
if necessary for timing considerations. See Appendix A-4 for Delays. 
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X Bar Graph, X, Value - (binary 250) 
The X Bar Graph, X, Value is entered by a binary 250 
code after the general Plot mode is entered. From the Keyboard use 
Control ":" or F1O. It may also be entered from any of the other plot 
Submodes except Character Plot. After entering the X Bar Graph, Xo Value 
Mode, the next word sent defines the X, Value or the left horizontal 
Start block of the horizontal bar graph. The graph grid is referenced 
to the lower left hand corner of the face of the CRT. The X, may range 
in value from 0 to 159 and all other values have 160 subtracted and the 
new value calculated for XK. 


Upon receipt of the Xo Value, the value of X, is 
stored in memory and the terminal is automatically placed in the X 
Bar Graph, Y Value mode (binary 249). The terminal is now ready to 
receive the next eight bit word as the Y position of the bar graph. 
Upon receipt of the Y value, the terminal is then automatically placed 
in the X Bar Graph, X Max Value mode (binary 248). The terminal is 
now ready to receive the next eight bit word as the X Max Value. 
Upon receipt of the X Max Value, the bar is drawn on the CRT and the 
terminal is placed back into the X Bar Graph, Y Value mode (binary 251) 
ready to receive a new Y value to begin the bar graph drawing process 
Over again as outlined above. This process is shown below and in 


Appendix B. 


Function Code 
Plot Mode 2 
or or 
Plot Submode 240 to 253 
X Bar Graph, Xo Value 250 
X, Value Word lL O to 159 
Y Value Word 1 O to 99 (0-191) 
X Max Value Word 1 O to 159 
Y Value Word 2 O to 99 (0-191) 
X Max Value Word 2 O to 159 
Y Value Word n O to 99 (191) 
X Max Word n O to 159 
Plot Escape 255 
or or 
Plot Submode 240 to 254 


NOTE: Use Code 251 between Y value, X max Value data sets 
for timing considerations. Timing delays depends directly upon the 
length of the bar being intensified. SeeAppendix A-4 for delays both 
minimum and maximum. 


As can be seen from the above process, once in the 
X Bar Graph, Xu mode, it is necessary to send only two words, Y and X 
Max, to completely define other bar graphs with the same Ke in the 
horizontal direction. As before, any of the submodes can be entered 
independently. After the first bar graph sequence, additional bar graphs 
can be described by a new Y position for the graph and a new X Max 
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Value for the graph. The bar is drawn after the X Max Value is received 
using the original value of X,. 


Any of the other plot submodes may be entered directly 
from the X Bar Graph, entering the appropriate plot submode codes which 
range from binary 240 to 254. 


This mode allows bar graphs in any color or multiple 
colors to be drawn with a width as small as one plot block wide or 
areas under curves may be easily filled in. 


X Bar Graph, Y Value - (binary 249) 


| The X Bar Graph, Y Value is entered by a binary 249 
code after the general Plot Mode is entered. From the Keyboard use 
Control "9" or F9. It is more commonly entered from the X Bar Graph, 
ae Value automatically, and may also be entered from any of the other 
plot submodes except Character Plot (binary 254). After entering 
the X Bar Graph, Y Value mode, the next word sent defines the Y 
or vertical position of the horizontal bar graph being drawn. The 
Y value may range from binary O to 99 (0 to 191) and all other values 
will have 100 (192) subtracted from it and the new value calculated for 
the Y value. 


Upon receipt of the Y value word, the value of Y is 
stored in memory and the terminal is automatically placed in the X Bar 
Graph,. X Max Value mode, as explained more completely in the Section on 
(binary 248). | 

Any of the other plot submodes may be entered directly 
from the X Bar Graph, Y Value mode by simply entering the appropriate 
plot submode codes which range from binary 240 to 254. 


X Bar Graph, X Max Value - (binary 248) 


The X Bar Graph, X Max Value is entered by a binary 
248 code after the general Plot Mode is entered. From the Keyboard use 
Control "8" or F8. It is more commonly entered from the X Bar Graph, Y 
Value automatically, and may also be entered from any of the other plot 
submodes except Character Plot. After entering the X Bar Graph, X Max 
Value mode, the next word received defines the X Max horizontal point of 
the horizontal bar graph being drawn. The X Max Value may range from 
O to 159 and all other values will have 160 subtracted from it and the 
new value calculated for X Max Value. 


Upon receipt of the X Max Value word, the bar graph 
is drawn in the predefined color on the face of the CRT according to the 
X5 and Y value stored in memory from previous operations. The terminal 
is then automatically placed in the X Bar Graph, Y Value mode, binary 249, 
for the beginning of a new bar graph as more completely explained in the 
Section on (binary 248). | 


Any of the other plot submodes may be entered directly 
from the X Bar Graph, X Max Value mode by simply entering the appropriate 
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plot submode codes which range from binary 240 to 254. 


X Incremental Bar Graph - (binary 247) 


The X Incremental Bar Graph is entered by a binary 247 
code after the general Plot Mode is entered. From the Keyboard use 
Control "7" or F7. It may also be entered from any of the other plot 
submodes except Character Plot. After entering the X Incremental 
Bar Graph mode, the next word sent defines the next two horizontal and 
vertical increments for two horizontal bar graphs. Thus, one may 
position a bar graph each side of the present location and add or 
subtract an increment to the bar graph previously defined. The coding 
and composition is the same as explained in the Section on (binary 251). An example 
1s shown in Appendix B-6. 


Y¥ Bar Graph, Y, Value - (binary 246) 

The Y Bar Graph, Y, Value is entered by a binary 246 
code after the general Plot Mode is entered. From the Keyboard use 
Control "6" or F6é. It may also be entered from any of the other plot 
Submodes except Character Plot. After entering the Y Bar Graph, Y, Value 
mode, the next word sent defines the Y, or the vertical start point of the 
vertical bar graph being drawn. The range of the Y, word ts 0 to 99 
(0-191) and all other values have 100 (192) subtracted and will have the 
new value calculated for Y, Value. 


All other operations are identical as explained in the 
Section on (binary 250), X Bar Graph, Xo Value except that Y Bar Graph, X Value 
and Y Bar Graph, Y Max Value are applicable for drawing vertical bar 
graphs. An example is shown in Appendix B-5. 


Y Bar Graph, X Value - (binary 245) 


The Y Bar Graph, X Value is entered by a binary 245 
code after the general Plot Mode is entered. From the Keyboard use 
Control "5" or F5. It is more commonly entered from the Y Bar Graph, 

Y, Value automatically, and may also be entered from any of the other plot 
Submodes except Character Plot. After entering the Y Bar Graph, X Value 
mode, the next word sent defines the X, or horizontal position of the 
vertical bar graph being drawn. The X Value may range from 0 to 159 and 
all other values will have 160 subtracted and will have the new value 
calculated for the X value. 


All other operations are identical as explained inthe 
Section on binary 249, X Bar Graph, Y Value except that Y Bar Graph, Yo Value 


and Y Bar Graph, Max Value are applicable for drawing vertical bar 
graphs. An example is shown in Appendix B-5. 
Y Bar Graph, Y Max Value - (binary 244) 
The Y Bar Graph, Y Max Value is entered by a binary 


244 code after the general Plot Mode is entered. From the Keyboard use 
Control "4" or F4. It is more commonly entered from the Y Bar Graph, X 
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Value automatically, and also may be entered from any of the other 

plot submodes except Character Plot. After entering the Y Bar Graph, 

Y Max Value mode, the next word received defines the vertical Y Max point 
of the vertical bar graph being drawn. The Y Max Value may range from 
binary 0 to 99 (0-191) and all other values will have 100 (192) 
subtracted and will have the new value calculated for Y Max Value. 


All other operations are identical as explained inthe 
Section on (binary 248), X Bar Graph, X Value, except that Y Bar Graph, Yo Value 
and Y Bar Graph, X Value are applicable for drawing vertical bar graphs. 
An example is shown in Appendix B-5. 


Y Incremental Bar Graph - (binary 243) 


The Y Incremental Bar Graph is entered by a binary 243 
code after the general Plot Mode is entered. From the Keyboard use Control 
"3" or F3. It may be entered from any of the plot submodes except Character 
Plot. After entering the Y Incremental Bar Graph mode, the next word sent 
defines the next two horizontal and vertical increments for two vertical 
bar graphs. 


All other operations are identical as explained in the 
Section on (binary 247), X Incremental Bar Graph except for the mode being 


applicable for drawing vertical bar graphs. An example iS shown in Appendix 
B-6. | 


Vector Mode X,Value - (binary 242) 


The Vector Mode is entered by a binary 242 code after 
the general Plot Mode is entered. From the Keyboard use Control "2" 
or F2. It may be entered from any of the plot submodes except Character Plot. 
After entering the Vector Mode, Xo Value, the next word defines the X, 
Value point of the vector being drawn. 


The Vector Mode requires the two end points to be 
defined (i.e. X, Yo and Xy Yj). ‘The Xi 7Yy values should previously be 
defined by way of the X,Y Point Plot Mode. 


Upon receipt of the X, Value the terminal is automatically 
placed in the Vector Y, Value Mode (binary 241). The terminal is now ready 
to receive the next eight bit word as the Y, Vector Value. Upon receipt 
of the Y, Value the terminal then determines the best straight line fit between 
Xo, Yo and X,, Yy using the plot blocks. The terminal will then revert to 
the Vector Mode X, value (binary 242), ready to receive the new X, Value 
for another vector. The process is shown below and in Appendix B-7. 
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Function Code 


Plot Mode 2 
or 
X point Plot submode 253 
X; Vector point l O to 15 
Y} Vector point l OO: 99 191) 
Xo Vector plot submode 242 
Xo Vector point 1 0. to 159 
Yo Vector point 1 0 to 99 (191) 
Xo Vector point N-1 O60: 4259 
Yo Vector point N-1l O: 1o-'99 (191) 
Xo Vector point N DEO 159 
Yo Vector point N O to 99 (191) 
Plot Escape 255 
or 
Plot Submode 240 to 254 


NOTE: Send code 242 between Yo vector point and Xy vector point 
words if necessary for timing considerations. See Appendix A-4 for 
delays. 


Vector Mode Y_ Value - (binary 241) 


The Y, vector is entered by binary 241 code after the 
general Plot Mode is entered. From the keyboard use Control "1" 
or Fl. This mode is more commonly entered automatically from 
the X, Vector mode. After entering the ¥, Vector mode, the next word 
defines the Y, value of the vector being drawn. There is no restriction on 
Yo with respect to Y; except it must be in the range of 0 to 99 (191). Upon 
receipt of the Y. value a vector is drawn from Xj, Y to Kor Yor with 
the new X ]Y; now al the old X.V¥..  .£ the next vector has a *;¥7] value = 
X5Y, old, then only the new XoYo need be sent. This would effectively draw 
a vector from the present Xo Yo position to the new X,Y, point. See 
Appendix B-7. 


Xo Yo - Incremental Vector Mode - (binary 240) 


The: Xe ¥ incremental vector mode is entered by a binary 
240 code after the general plot mode is entered. From the keyboard use control 
"O" or FO. It may also be entered from any of the other plot submodes 
except Character Plot. After entering the incremental vector mode, the next 
word sent defines the increments in X,, Yo, X; and Y point values for the 
vector from X,Y} to X,Y,. This word may have a range from binary 0 to 239 
Since binary 240 to 255 are used for the plot submode codes. 


Referring to the section on (binary 251), XY Incremental Point Plot 
it can be seen that there is one two bit element available for each of the 
4 points (i.e. Xp, Yo, X, and Yy ). TheAX.,AY refers to the increment in 


Xj, ¥ ] of the vector and the AX), AY) refers to the increment in X,, Y, of the 
vector. 
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Therefore, if bg and bs are both 1 or both g then no 
increment will take place. If either half of the word is all zero then the 
corresponding X,Y will be changed but no vector will be drawn. This allows 
the user to eaSily "Skip" points. The only time a vector will be drawn is 
when both halfs of the word are non zero. 


The incremental vector plot mode does not automatically 
transfer control to any other mode. It remains in this incremental mode until 
terminated by a plot submode code. Therefore a series of incremental 
movements in both X,, Yoand X1Y may be made by sending consecutive incremental 
change words. 


The procedure for entering and exiting the XY Incremental plot 
mode are shown below: 


Function Code 
Plot Mode 2 
Or or 
Plot Submode 240 to 253 
Incremental Vector 240 
Plot Mode 


Incremental change 


in Xq, Yq, Xo» Yo 
Word 1 0 to 239 
Word N O° 6° 239 
Plot Escape 209 
or or 
Plot Submode 240 to 254 


NOTE: Send code 240 between incremental vector words if 
necessary for timing considerations. See Appendix A-4 for input 
Delay Times. 
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LIGHT PEN OPERATION (Option 28) 


The Intecolor 8001 Light Pen is designed to move the cursor on 
the screen of the terminal by simply pointing to the desired location on the 
screen and touching with the forefinger the touch-sensitive end of the light 
pen. The touch sensitive end of the light pen acts as a switch or button. 


To effect operation of the light pen, the pen is simply pointed to 
the desired location on the screen. Either the standard lense or the long range 
lense may be used in the same manner. When the desired location is reached, 
the forefinger is placed on the touch-sensitive end of the pen and held 
on the pen until the cursor on the screen resides at the location the pen 
1S pointing to. As long as the finger is kept on the pen the cursor will 
follow the pen to any location. 


When the cursor is at the desired location, lift the forefinger from the 
tip of the pen and the following 7 word sequence will be transmitted to the Jl 
RS232 output port. 


03 Cursor X-Y (See Code 3) 

X X Cursor Coordinate 

Y Y Cursor Coordinate 

06 CCI (See Code 6) 

Status Status Character (See Appendix A-6) 
ASCII or 

Special 

Character 

8D Carriage Return 


Notice that this sequence is not transmitted unless the 
finger first touches the end of the pen in the touch sensitive area and is 
effected when the finger is lifted from the end of the pen. 


Note that a blue flood is normal operation and occurs every 


time the touch sensitive end of the pen is touched by the forefinger and 
will repeat at a 2cps rate until the finger is lifted. 


sf 


APPENDIX A 


we ale ee Ie ee bee ee ae eee aioe Mette oe ek fee ph eta phe 
| 
| 


| 
FG ON | BGON 
ace] ae [So 
¥ BAUD | (TEXT (INS TAB BLINK/| (C 
6 ROWS =5.906 ATE) | EDIT) LINE) AT OFF |} OP ,| 8G ON 
5 ROWS = 5.156" R U I 0 FLG ON 
ccLr BELL ’ ERASE 
PAGE ; 
F G J L : 


CYAN Sone 
iS PLOT | AT ON > ) PLOT | 
LINE ¢ 

V B N ’ . 7 YELLOW] WHITE | a7 ore 


WITH OPTION 8 AND 32 


21.010" 


retrace = ee eer en ee the ce rr Ne = ey ee ee 
1 | I | | ' i | I 


| 
| 
FG ON | BG ON 
ERASE | CPU FG ON 
setuid FLG ON SACE. aEcEy BLACK| BLUE |-. 6 of 
BLINK/| (CPU 
NULL LINE 
AT OFF JOP SYS) FEED | RETURN 
6 ROWS =5.906" Y fe) P | @ Cc 
5 ROWS =5.156 “ ccr | BELL | HOME ERASE |ERASE] 4 BLINK 
INE | PAGE ; DELETE| ON | BREAK 
F G H : —_— 
CURSOR] (DEL | PLOT | A7 ON 
LINE) 
Vv B 


WITH OPTION 22 


18.385" 


r | | | | l 


FG ON | BG ON 
ERASE | CPU 
FI 
Ls. OFF FLG: ON ae 
BLINK 
TAB NULL LINE 
AT OF FEED | RETURN 
6 ROWS = 5.906" I C 
apes CCI | BELL | HOME | 4 |ERASE|ERASE) + BLINK 
eRe wei ease LINE | PAGE | » |OELETE] ON [BREAK 
F G H J K L ; : _ 


XMIT [CURSOR] (DEL PLOT | A7 ON 
SHIFT XY | LINE) = 
Z X C Vv B N ’ is 


NOTE ! IF 16 FUNCTION KEYS ARE REQUIRED THEN 
THEN A SIXTH ROW OF KEYS ARE ADDED 
AS SHOWN DOTTED. 
STANDARD 


12.76" 


A-1 
KEYBOARD LAYOUTS 


STATUS 
7 6 5 4 3 2 1 O- 


Plot/Blink | BB BG 


OPTIONAL FUNCTION KEYS 


CONTROL CONTROL SHIFT SHIFT % SHIFT % | CONT -SHIFT |CONT - SHIFT | CONT-SHIFT 
@ TO 0 P TO _ 9 TO ? @T00 P TOW PTO_ 


NULL BLACK SPACE 
ie) 16 32 


CONT CONTROL SHIFT CONT — SHIFT 
@T0? FO-FI5 FO-FI5 FO-FI5 
P \/60 P/GI6 @ SPACE ® FO FO FO 
80 6 2 128 160 176 192 208 224 eREMEN ae veers 


oJ 
a4 
| 2 
QO 
ra] 
4 
x< 
WwW 
x 
pofe jefe fo. 48 oO 9 
PROTECT a/Gl q/GI7 Yo VECTOR PLOT 
| 7 97 WS 177 
2 66 38 114 130 146 I78 194 210 
CURSOR 
3 19 67 99 NS 147 179 227 
4 20 36 68 84 100 6 i48 164 ig 196 244 
5 21 37 10! NT 197 213 
6 22 38 70 86 102 118 150 166 198 230 
T 23 55 Ti 87 103 1G7 183 99 215 23 247 
24 72 88 104 120 184 200 232 248 
CURSOR 
TAB RIGHT 9 r Y i/69 y/G25 I Y FO Y—-X BAR 
9 25 57 73 89 105 121 137 153 217 
LINE CURSOR 
FEED LEFT J j/G10 2/626 J * 
10 26 74 106 122 138 170 : 
ERASE x-Y 
LINE ESC + K k/GII { /627 + INCREMENTAL PLOT 
tt 27 43 75 107 123 17! 
ERASE CURSOR ' 
Cc PAGE UP < L \ 1/612 1/628 L \ ’ < Fl2 Y-POINT PLOT 
12 28 60 76 92 108 124 140 156 I72 188 220 5g 
FOREGND ON 
D FLAG M m/GI3 3/629 3 - FI3 X-POINT PLOT 
29 OFF 77 109 125 157 173 237 
BACKGND ON 
FLAG > N A n/Gi4 JS71630 A . > FI4 CHAR PLOT 
oy 62 78 94 HO i26 188 174 190 206 
47 63 79 iW | 127 175 191 207 
NOTE: THE TERMINAL ACCEPTS ALL 8@ TO BF HEX CODES FROM THE KEYBOARD AND REASSIGNS THEM 
F® TO FF HEX WHEN IN THE PLOT MODE , UNLESS THE OPTIONAL KEYS ARE INSTALLED. THEREFORE 
WITHOUT THE FUNCTION KEYS THE KEYBOARD CAN PLOT IN A RANGE OF @TO 175. 
% COLUMNS 6 AND 7 WILL BE TRANSLATED TO COLUMNS O AND | RESPECTIVELY IN THE CRT REFRESH 
A-2 RAM IF THE FLAG ON HAS BEEN SET BEFORE ENTERING THESE CODES. THEY WILL THEN APPEAR 


AS THE SECOND GROUP OF 64 CHARACTERS IF THAT OPTION IS SUPPLIED. 


INTECOLOR 8001 CODE SET 


ANY ONE OF 


256 INPUT 
CODES 


ANY ONE OF 
2ND 128 INPUT 


ANY ONE OF 
FIRST 128 INPUT 


32 SPECIAL IF ONE OF 
CHARACTER 32 CONTROL 
CODES CODES 


64 ASCIT 


CHARACTER 
CODES 


2ND 32 
SPECIAL 
CHARACTERS 


IST 32 
SPECIAL 
CHARACTERS 


CONTROL CODE 29 CONTROL CODE 30 ALL OTHER 
REVERSE FIELD REVERSE FIELD CONTROL 
OFF * ON * CODES 


CONTROL CODE 2 CONTROL CODE 3 
PLOT MODE CURSOR X-Y 
OPTION MODE 


CONTROL CODE 6 CONTROL CODE 27 
CCI MOVE ESC 


ONE OF 256 
COLOR AND 
BLINK STATUS 


— NORMALLY FOLLOWED NORMALLY FOLLOWED 
ONE OF 32 BY A COLOR CODE BY A COLOR CODE 


ONE OF |6 
CURSOR MODES 
SEE FIGURE 2.6 


SEE 


FIGURE 2.6.3.1 


ESCAPE CODES OR GO TO G3I OR GO TO G3l 


WORDS **¥ SEE SECTION 2.5.20 
t THIS IS VALID ONLY IF THE A7 % THIS CODE DOES NOT REQUIRE %% SEE SECTION 2.6.7 FOR 
BIT IS NOT MASKED OFF AT ANY FOLLOW-ON CODE DEFINITION OF THE 8 BITS 
CUSTOMER REQUEST OF THE STATUS WORD 
A-3 


INPUT CODE FLOW DIAGRAM 


Delay Times are in Milliseconds 


Mode Normal 
Blind Cursor -278 
Character Store 
Most Control 
Codes 46 
Erase Line 1.45 
Erase Page 16 (30)* 
Visible Cursor 
Character Store 
Left-Right {51 
2X Char .59 

oO 
down @ 45 s75 
Insert 80 
Characters 4.82 
Delete 80 Characters 4.34 
X,Y Point Plot .40, .63 
XY Increment 
2 points Ls2 
100 Element 
X Bar Graph 5.45 
100 Element 
Y Bar Graph S426 
100 Element Vector 34 
*48L Delay time in (_ ) 
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INPUT COMMANDS DELAYS 


High Speed Option 


ead 


40 


1A ck: C25)" 


-430 


£335 209 


4,53 


28.3 


Ccl CHARACTER MODE ( PLoT G: Plot _: PRinT"_*) 
FoRE GROUND 


po [a GREEN 
0 


CZOCOCADZKN SW 


| a Sl 52. | 

= 4 us NG M7 wo - 

5 | | GI ’ - 

we 7 |e [59 “[oo [or [a [os 
a 122} 123] 124] 12s] pac] 427 


eo —_—_—_———_—_—_"—""""——— 6 
0,0 73,0 
PLOT 3 
(80,0 takes 
Cursur OFF 
screen ) 
0,47 | 75,47 
ee © 


SCREEN LAYOUT 


' STANDARD INTECOLOR, 8001 


Ay Ag As Ay A3 Ay Ay Ao 

0 0 0 0 O 0 O 1 RED FOREGROUND 

O 0 O O 0 O iL 0 GREEN FOREGROUND 
O 0 0 0 O 1 O O BLUE FOREGROUND 
0 1 O O O O O O FOREGROUND BLINK 
1 0 O 0 O O O 0 PLOT CHARACTER 


WITH BACKGROUND COLOR OPTION 


Ao Ag Ag Ay A. Ay Ay Ay 

0 @) O 0 0 0 @) 1 RED FOREGROUND 

0 0 O 0) 0 0 1 0 GREEN FOREGROUND 
0 0 0 0 O il 0 @) BLUE FOREGROUND 
0 O 0 @) 1 0 @) 0 RED BACKGROUND 

@) O O us O 0 0 @) GREEN BACKGROUND 
0 0 1 0 0 0 @) 0 BLUE BACKGROUND 
0 1 O 0 O 0 @) 0 FOREGROUND BLINK 
1 O O O O 0 @) 0 


PLOT CHARACTER 


The above codes may be "ORed" for composite functions 
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CCI CODE ASSIGNMENTS 


FUSE 


POWER 
2ND RS232C I/0 


JI AC POWER 


14 


SERIAL RS-232C EIA KEYBOARD 
20MA CURRENT LOOP OPTIONAL 


NOTES: (1) JI-SERIAL RS-232C EIA AND CURRENT LOOP ARE NOT SIMULTANEOUSLY AVAILABLE IN 
RECEIVE MODE .PIN NUMBERS ARE FOR STANDARD EIA RS-232C ,25 PIN, CHASSIS MOUNT PLUG. 


(2) MATING PLUGS & RECEPTACLES FOR REAR CHASSIS CONNECTORS : 


Jl ,J3(EIA,25 PIN RECEPT.) - AMP205207-| OR EQUIVALENT -— ISC PN. 600040 
J2(25 PIN PLUG ) - AMP205208-| OR EQUIVALENT - ISC PN. 600052 
AC POWER CORD — BELDEN 172588 OR EQUIVALENT - ISC PN. 110036 


CRIMP PINS FOR PLUG ~ AMP 20520! —5 OR EQUIVALENT - ISC PN. 600044 
CONNECTORS 
CRIMP SOCKETS FOR - AMP 205202-4 OR EQUIVALENT - ISC PN. 600046 


RECEPTACLE CONNECTORS 


( ) ALL CHASSIS MOUNT CONNECTOR PIN AND SOCKET NUMBERS ARE SHOWN AS VIEWED 
FROM THE REAR OF THE INTECOLOR® 800! CHASSIS. 
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Jl AND J2 PIN ASSIGNMENTS 


1. AA | 1. AA 10. IN OA | Key PO. IN OC 
2. BA 2. BA 7 9. IN 1A | Data 9. IN 1c 
3. BB 3. BB | 21. IN 2A | Bits 21. IN 2c 
4. CA 4. 470 ohms to +12V 8. IN 3A [1-4 ». <2: 5IN 3e 
5. CB 5. 20. IN 4A~ Control 205 IN ae: 
6. 6. 7. IN 5A Shift 7. IN 5¢C 
7. AB 7. AB 19. IN 6A Key Data B5 | 19. IN 6C 
Sy 8. 6. IN 7A Key Data B6 6. IN 7C 
9. RX Response Control} 9. RX Response Control 12. IN 4B }{ Not } 2. OUT OC 
10. RX Responce Control|10. RX Response Control | 23. IN 5B | Used | 14. out ic 
ae 11. CLR+ 11. IN 6B 3. OUT 2c 
12. TTL TX A 12. TTL TX 22. IN 7B Key Trigger | 15. .ouT 3c 
13. 13. TX Isolator input 2. OUT OA RX ACK 4. OUT 4c 
14. Ae, 14. ouT 1A 7 16. out 5c 
15. 15. 3. OUT 2A | 5. out bc 
16. 16. 15. OUT 3A 17. ouT 7c 
ny hs 4. OUT 4A 13. CPU RESET 
18. 18. CLR- 16. OUT 5A 24. 2nd RS232 TX 
19. | 19. 5. OUT 6A Bell 11. 2nd TTL Tx 
20. CD 20. 470 ohms to +12V 17. OUT 7A -Key ACK 22. 2nd RS232 RX 
Ole 21. CLT+ | 13. CPU RESET 12. +12V 
22% 22s 1. SN -Key Inturr. 23. -12V. 
23. | 23. 25. +5V 25. +5V 
Da. 23. 18. GND 18. GND 
253 25. CLT- 1. SN - EXT Inturr. 


An external jumper 
is required from 
pin 12 to pin 13. 


A 2.2K ohm register 
is required from 
pin 3 to pin 4. 


STANDARD TTY | OPTIONAL 
EIA RS2326 20MA Current Loop. 
JL | (o2 | BB 
SERIAL INPUT/OUTPUT a KEYBOARD | - OPTIONAL : 


PARALLEL INPUT /OUTPUT 
AND 2nd PS232C 
a a aa ce a 
A-7 | | 
1/O Connector Layout 
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BINARY CODE = 


TWO'S COMPLEMENT= 


SETS PLOFL TO = 
FUNCTION = 
NEXT WORD = 


RANGE FROM = 
TO = 


CHANGE PLOFL TO = 


BINARY CODE = 


TWO'S COMPLEMENT= 


SETS PLOFL TO = 
FUNCTION = 
NEXT WORD = 


RANGE FROM = 
TO = 


CHANGE PLOFL TO= 


PLOT ESCAPE 


N/A 


N/A 
N/A 


N/A 


247 
(-9) 
8 


X INCREMENTAL 
BAR GRAPH 


X| 


y 


Xo Yo 


0 
239 


8 (SAME) 


254 
(-2 ) 


CHARACTER PLOT 
PLOT CHARACTER | 


0 
254 


| (SAME) 


246. 
(-10) 
9 
Y BAR GRAPH 
Yo VALUE 


fe) 
100 (i91) 
10 


253 
(-3) 
2 


1X-Y POINT PLOT 


X VALUE 


0) 
159 


3 


245 
(-11) 
10 
Y BAR GRAPH 
X VALUE 


6) 
159 


PLOT MODE 
OR 
CONTROL CODE B 


SETS PLOFL =2 


252 
(-4) 
3 : 
X-Y POINT PLOT 
Y VALUE 


0 
100 (191) 
2 


244 
(-12) 
i 
Y BAR GRAPH 
Y MAX VALUE 


100 (9) 


10 


B-1 


25) 
(-5) 
4 
INCREMENTAL 
X-Y PLOT 


0) 
239 


4 (SAME) 


243 
(-13) 
12 


Y INCREMENTAL 
BAR GRAPH 


AX, SY, 4Xp SYp | 


.e) 
239 


12 (SAME) 


PLOT MODE FUNCTIONS 


250 
(-6 ) 
5 


X BAR GRAPH 


Xo VALUE 


0 
159 


6 


242 
(-14) 
13 
VECTOR 
Xo VALUE 


0 
259 


14 


249 
(-7 ) 
6 
X BAR GRAPH 
Y VALUE 


00 (ial 
7 


241 
(-15) 
14 
VECTOR ° 
Yo VALUE 


0 
191 


2 


248 
(-8 ) 
7 
X BAR GRAPH 
X MAX VALUE 


0 
159. 


8 


240 
(-16) 

15 
INCREMENTAL 
X~-Y VECTOR 

OX AYi AXo AYo 


0 
239 


15 


CHARACTER PLoT MODE (Prot 2: ProTas4: PLoTA:) 
( Prot AK : PLoTZSS ) 


HS Sta 3 St SLs Ga i 


V ON nA WR Wp ~ 


—_— mM ~~ 
wife = Gg 


POS CeSUOSeenecao 


32 

33 
44 
3s 
36 


47 


So 
45 6 $I 
So 66 %2 
gs. 47 83 


Gl i et 


97 
9g 
99 


(2 


{28 


174 (92 208 224 240 
(45 (ht (77 693 209 225 24I 
M (62 \7g 194 2to 22.6 242 
47 (63 179 195 2M 227 243 
4g (4 to 156 202 2% 244 
(49 165 (8 J97 213 229 245 
So (46 (82 198 214 230 24% 
IS} te? {33 199 26 2% 247 
$2 148 [24 Zoo 244 232 248 
(53 uw 195 zor 27 «223 243 
154 17% 184 202 218 234 250 
5S 1% 187 203 219 235 251 
(1% "72 (Ee 204 220 2% 262 
IS? {73 [89 20S 221 237 253 
Sg 174 190 206 222 238 25¢ 
ISD (35 19) 207 223 239 MA 


PLOT n From above table to print desired com bed 
Sequential PLOTs print as a Ty pewertler : 


pattern . 


on nn nn ® 
0,191 159,19] 


PLoT 253 
PLOT 242 


SCREEN LAYOUT 


lO HEX 


00001000 
B-2 


Note: Each of the above codes may be "ORed" for composite 
symbols. 


PLOT MODE CHARACTERS AND CODES 
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X POINT PLOT AND Y POINT PLOT 


AX, AY, 


A Xy AY, 
Finish 


BRERR EEE 
a ee | 
SEZEIG 
S2ZE RIAN 
45 ESHER EE 


AX, AY, (1010) 


0,9 Movement and Coding Example 


(0010) 
Y (0110) AY=+1  AX=+1 (1010) 
Ax=-1 AX= 0 Ay=+l 


rei (1000) 
a a oe 


A 


AX=+1 1001 
AY=-1 ( ) 


(\ 


Y 
hee (0001) 


1 
0 


0,0 AO 
Movement Possibilities 
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XY INCREMENTAL POINT PLOT MOVEMENTS 


Y BAR GRAPH 


. f__» x 
0,0 %*o K Max, KX Max, X Max, 


X AND Y BAR GRAPH MODES 


Pifeo 


GN 
AR 
~< 
Se) 
ae 


i 


T+=A°T+=X 9! 


Y 


Y Incremental Bar Graph 


reo Pesf ba] bs] bof bi fbo) 


AX 


pop ops fi pop oy 


X Incremental Bar Graph 


Appendix B6 


X INCREMENTAL BAR GRAPH, Y INCREMENTAL BAR GRAPH 


XI 0V9 
y2 
2 This vector drawn by 
send binary sending x2,y9 
70 


1 Line drawn from x}1,yj 
to Xp,¥q at XQ>Yo with 
X1,y , now equal to old 
XQ Yo 


B-7 


Xo Yo Vector Plot Mode 
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1.1 


TMS 5501 MULTIFUNCTION INPUT/OUTPUT CONTROLLER 


INTRODUCTION 
DESCRIPTION 


The TMS 5501 is a multifunction input/output circuit for use with Tl’s TMS 8080 CPU. It is fabricated with the same 
N-channel silicon-gate process as the TMS 8080 and has compatible timing, signal levels, and power supply 
requirements. The TMS 5501 provides a TMS 8080 microprocessor system with an asynchronous communications 
interface, data I/O buffers, interrupt control logic, and interval timers. 


SYNC CE XI xO 


INT 
CONTROL STATUS 
A0.A3 
4 
{8 
8 
00-D? 7 BUFFER 


8 


OUTPUT 
PORT 


8 


INTERRUPT 
ADDRESS 


8 


TRANS. 
MITTER 
BUFFER 


INTERVAL 
TIMERS 


RECEIVER 
BUFFER 
RECEIVER 
REGISTER 


FIGURE 1—TMS 5501 BLOCK DIAGRAM 


5 


TRANS. 
MITTER 
REGISTER 


MASK 
REGISTER 


The I/O section of the TMS 5501 contains an eight-bit parallel input port and a separate eight-bit parallel output port 
with storage register. Five programmable interval timers provide time intervals from 64 us to 16.32 ms. 


The interrupt system allows the processor to effectively communicate with the interval timers, external signals, and the 
communications interface by providing TMS 8080-compatible interrupt logic with masking capability. 


Data transfers between the TMS 5501 and the CPU are carried by the data bus and controlled by the interrupt, chip 
enable, sync, and address lines. The TMS 8080 uses four of its memory-address lines to select one of 14 commands to 
which the TMS 5501 will respond. These commands allow the CPU to: 


---- read the receiver buffer 

---- read the input port 

---- read the interrupt address 
---- read TMS 5501 status 

---- issue discrete commands 
---- load baud rate register 

---- load the transmitter buffer 
---- Joad the output port 

---- load the mask register 

---- Joad an interval timer _ 


1.2 


The commands are generated by executing memory referencing instructions such as MOV (register to memory) with the 
memory address being the TMS 5501 command. This provides a high degree of flexibility for |/O operations.by letting 
the systems programmer use a variety of instructions. 


SUMMARY OF OPERATION 
Addressing the TMS 5501 


A convenient method for addressing the TMS 5501 is to tie the chip enable input to the highest order address line of 
the CPU's 16-bit address bus and the four TMS 5501 address inputs to the four lowest order bits of the bus. This, of 
course, limits the system to 32,768 words of memory but in many applications the full 65,536 word memory 
addressing capability of the TMS 8080 is not required. 


Communications Functions 


The communications section of the TMS 5501 is an asynchronous transmitter and receiver for serial communications 
and provides the following functions: 


Programmable baud rate — A CPU command selects a baud rate of 110, 150, 300, 1200, 2400, 4800, or 9600 baud. 


Incoming character detection — The receiver detects the start and stop bits of an incoming character and places the 
character in the receive buffer. 


Character transmission — The transmitter generates start and stop bits for a character received from the CPU and 
shifts it out. 


Status and command signals — Via the data bus, the TMS 5501 signals the status of: framing error and overrun error 
flags; data in the receiver and transmitter buffers; start and data bit detectors; and end-of-transmission (break) signals 
from external equipment. It also issues break signals to external equipment. 


Data Interface 


The TMS 5501 moves data between the CPU and external devices through its internal data bus, input port, and output 
port. When data is present on the bus that is to be sent to an external device, a Load Output Port (LOP) command from 
the CPU puts the data on the XO pins of the TMS 5501 by latching it in the output port. The data remains in the port 
until another LOP command is received. When the CPU requires data that is present on the External Input (X1) lines, it 
issues a Command that gates the data onto the internal data bus of the TMS 5501 and consequently onto the CPU’s 
data bus at the correct time during the CPU cycles. 


Interval Timers 


To start a countdown by any of the five interval timers, the program selects the particular timer by an address to the 
TMS 5501 and loads the required interval into the timer via the data bus. Loading the timer activates it and it counts 
down in increments of 64 microseconds. The 8-bit counters provide intervals that vary in duration from 64 to 16,320 
microseconds. Much fonger intervals can be generated by cascading the timers through software. When a timer reaches 
zero, It generates an interrupt that typically will be used to point toa subroutine that performs a servicing function 
such as polling a peripheral or scanning a keyboard. Loading an interval value of zero causes an immediate interrupt. A 
new value loaded while the interval timer is counting overrides the previous value and the interval timer starts counting 
down the new interval. When an interval timer reaches zero it remains inactive until a new interval is loaded. 
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Servicing Interrupts 


The TMS 5501 provides a TMS 8080 system with several interrupt control functions by receiving external interrupt 
signals, generating interrupt signals, masking out undersired interrupts, establishing the priority of interrupts, and 
generating RST instructions for the TMS 8080. An external interrupt is received on pin 22, SENS. An additional 
external interrupt can be received on pin 32, X17, if selected by a discrete command from the TMS 8080 (See 
Figure 4). The TMS 5501 generates an interrupt when any of the five interval timers count to zero. Interrupts are also 
generated when the receiver buffer is loaded and when the transmitter buffer is empty. 


When an interrupt signal is received by the interrupt register from a particular source, a corresponding bit is set and 
gated to the mask register. A pattern will have previously been set in the mask register by a load-mask-register command 
from the TMS 8080. This pattern determines which interrupts will pass through to the priority logic. The priority logic 
allows an interrupt to generate an RST instruction to the TMS 8080 only if there is no higher priority interrupt that 
has not been accepted by the TMS 8080. The TMS 5501 prioritizes interrupts in the order shown below: 


1st — Interval Timer #1 

2nd — _ Interval Timer #2 

3rd — External Sensor 

4th — _ Interval Timer #3 

5th — Receiver Buffer Loaded 

6th — Transmitter Buffer Emptied 

7th — _ Interval Timer #4 

8th — _ Interval Timer #5 or an External Input (XI 7) 


The highest priority interrupt passes through to the interrupt address logic, which generates the RST instruction to be 
read by the TMS 8080. See Table 3 for relationship of interrupt sources to RST instructions and Figures 6 and 8 for 


timing relationships. 


The TMS 5501 provides two methods of servicing interrupts; an interrupt-driven system or a polled-interrupt system. In 
an interrupt-driven system, the INT signal of the TMS 5501 is tied to the INT input of the TMS 8080. The sequence of 
events will be: (1) The TMS 5501 receives (or generates) an interrupt signal and readies the appropriate RST 
instruction. (2) The TMS 5501 INT output, tied to the TMS 8080 INT input, goes high signaling the TMS 8080 that an 
interrupt has occured. (3) If the TMS 8080 is enabled to accept interrupts, it sets the INTA (interrupt acknowledge) 
status bit high at SYNC time of the next machine cycle. (4) If the TMS 5501 has previously received an interrupt- 
acknowledge-enable command from the CPU (see Bit 3, Paragraph 2.2.5), the RST instruction is transferred to the data 
bus. 


In a polled-interrupt system, INT is not used and the sequence of events will be: (1) The TMS 5501 receives (or 
generates) an interrupt and readies the RST instruction. (2) The TMS 5501 interrupt-pending status bit (see Bit 5, 
Paragraph 2.2.4) is set high (the interrupt-pending status bit and the INT output go high simultaneously). (3) At the 
prescribed time, the TMS 8080 polls the TMS 5501 to see if an interrupt has occurred by issuing a read-— 
TMS 5501-status command and reading the interrupt-pending bit. (4) If the bit is high, the TMS 8080 will then issue a 
read-interrupt-address command, which causes the TMS 5501 to transfer the RST instruction to the data bus as data for 
the instruction being executed by the TMS 8080. 


APPLICATIONS 
Communications Terminals 


The functions of the TMS 5501 make it particularly useful in TMS 8080-based communications terminals and generally 
applicable in systems requiring periodic or random servicing of interrupts, generation of control signals to external 
devices, buffering of data, and transmission and reception of asynchronous serial data. As an example, a system 
configuration such as shown in Figure 2 can function as the controller for a terminal that governs employee entrance 
into a plant or security areas within a plant. Each terminal is identified by a central computer through ID switches. The 
central system supplies each terminal’s RAM with up to 16 employee access categories applicable to that terminal. 
These categories are compared with an employee's badge character when he inserts his badge into the badge sensor. If a 
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match is not found, a reject light will be activated. If a match is found, the terminal will transmit the employee’s badge 
number and access category to the central system, and a door unlock solenoid will be activated for 4 seconds. The 
central computer then may take the transmitted information and record it along with time and date of access. 


The TMS 4700 is a 1024 x 8 ROM that contains the system program, and the TMS 4036 is a 64 x 8 RAM that serves as 


~ the stack for the TMS 8080 and storage for the access category information. TTL circuits control chip-enable information 


carried by the address bus. Signals from the CPU gate the address bits from the ROM, the RAM, or the TMS 5501 onto 
the data bus at the correct time in the CPU cycle. The clock generator consists of four TTL circuits along with a crystal, 
needed to maintain accurate serial data assembly and disassembly with the central computer. 


The TMS 5501 handles the asynchronous serial communication between the TMS 8080 and the central system and 
gates data from the badge reader onto the data bus. It also gates control and status data from the TMS 8080 to the door 
lock and badge reader and controls the time that the door lock remains open. The TMS 5501 signals the TMS 8080 
when the badge reader or the communication lines need service. The functions that the TMS 5501 is to perform are 
selected by an address from the TMS 8080 with the highest order address line tied to the TMS 5501 chip enable input 
and the four lowest order lines tied to the address inputs. | 


OPERATIONAL AND FUNCTIONAL DESCRIPTION 


This detailed description of the TMS 5501 consists of: 
INTERFACE SIGNALS — a definition of each of the circuit’s external connections 


COMMANDS — the address required to select each of the TMS 5501 commands and a description of the response to | 
the command. 


INTERFACE SIGNALS 


The TMS 5501 communicates with the TMS 8080 via four address lines: a chip enable line, an eight-bit bidirectional 
data bus, an interrupt line, and a sync line. It communicates with system components other than the CPU via eight 
external inputs, eight external outputs, a serial receiver input, a serial transmitter output, and an external sensor input. 
Table 1 defines the TMS 5501 pin assignments and describes the function of each pin. 


TABLE 1 
TMS 5501 PIN ASSIGNMENTS AND FUNCTIONS 


SIGNATURE PIN DESCRIPTION 


INPUTS 


CE 18 Chip enable—When CE is low, the TMS 5501 address decoding is inhibited, which prevents 
execution of any of the TMS 5501 commands. 
A3 17 Address bus—A3 through AQare the lines that are addressed by the TMS 8080 to select a particular 
A2 16 TMS 5501 function. 
Al 15 
AO 14 
SYNC 19 Synchronizing signal—The SYNC signal is issued by the TMS 8080 and indicates the beginning of a 
machine cycle and availability of machine status. When the SYNC signal is active (high), the 
TMS 5501 will monitor the data bus bits DO (interrupt acknowledge) and D1 (WO, data output 
function). 
RCV 5 Receiver serial data input line—RCV must be held in the inactive (high) state when not receiving 
data. A transition from high to low will activate the receive circuitry. 
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SIGNATURE PIN 


X10 
XI 1 
Xl 2 
X13 
X14 
X15 
XI 6 
XI 7 


SENS 


XO 0 
XO 1 
XO 2 
XO 3 
X04 
XO 5 
X06 
XO 7 


XMT 


DO 
D1 
D2 
D3 
D4 
D5 
D6 
D7 


INT 


Vss 
VBB 
VCC 
VDD 
o1 
o2 


39 
38 
37 
36 
35 
34 
33 
32 


22 


TABLE 1 (continued) 
TMS 5501 PIN ASSIGNMENTS AND FUNCTIONS 


DESCRIPTION 
INPUTS 
External inputs— These eight external inputs are gated to the data bus when the read-external-inputs 
function is addressed. External input n is gated to data bus bit n without conversion. 


External interrupt sensing — A transition from low to high at SENS sets a bit in the interrupt 
register, which, if enabled, generates an interrupt to the TMS 8080. 


OUTPUTS 


External outputs—These eight external outputs are driven by the complement of the output 
register; i.e., if output register bit n is loaded with a high (low) from data bus bit n by a load- 
output register command, the external output n will be alow (high). The external outputs change 
only when a load-output-register function is addressed. 


Transmitter serial data output line—This line remains high when the TMS 5501 is not transmitting. 


DATA BUS INPUT/OUTPUT 


Data bus — Data transfers between the TMS 5501 and the TMS 8080 are made via the 8-bit 
bidirectional data bus. DO is the LSB. D7 is the MSB. 


Interrupt—When active (high), the INT output indicates that at least one of the interrupt conditions 
has occurred and that its corresponding mask-register bit is set. 


POWER AND CLOCKS 


Ground reference 

Supply voltage (—5 V nominal) 
Supply voltage (5 V nominal) 
Supply voltage (12 V nominal) 
Phase 1 clock 

Phase 2 clock 


2.2 TMS 5501 COMMANDS 


The TMS 5501 operates as memory device for the TMS 8080. Functions are initiated via the TMS 8080 address bus and 
the TMS 5501 address inputs. Address decoding to determine the command function being issued is defined in Table 2. 


TABLE 2 
COMMAND ADDRESS DECODING 
When Chip Enable Is High 


A3 A2 Al AQ COMMAND FUNCTION PARAGRAPH 
L L L L Read receiver buffer RBn~> Dn 2.2.1 
L L L H Read external inputs Xin > Dn 2.2.2 
L L H L Read interrupt address RST > Dn 2.2.3 
L L H H Read TMS 5501 status (Status) > Dn 2.2.4 
L H L L Issue discrete commands See Figure 4 225 
L HL H Load rate.register See Figure 4 2.2.6 
L HH L ° Load transmitter buffer Dn—-TBn 2.2.7 
L oH =H H_ Load output port Dn > XOn 2.2.8 
H OL L L Load mask register Dn MRn 2.2.9 
H L L H Load interval timer 1 Dn Timer 1 2.2.10 
H L H L Load interval timer 2 Dn Timer 2 2.2.10 
H L H H Load interval timer 3 Dn > Timer 3 2.2.10 
H H L L Load interval timer 4 Dn > Timer 4 2.2.10 
H H L H Load interval timer 5 Dn Timer 5 2.2.10 
H WH HL No function ~ 
H H H H No function 

RBn ~~ Receiver buffer bit n 

Dn Data bus 1/O terminal n 

Xin External input terminal n | 

RST 11 (1Aa) (1A4) ([Ag) 11-1 (see Table 3). 

TBn Transmit buffer bit n 

xXxOn Output register bit n 

MRn Mask register bit n 

TABLE 3 


RST INSTRUCTIONS 


eer INTERRUPT CAUSED BY 


0123 4 5 6 7 

H H H L L L H_ H Interval Timer 1 

H H H H L L H_ H Interval Timer 2 

H H H L H L H H External Sensor 

H H H H H L H_ H Interval Timer 3 

H H H L L H H H Receiver Buffer 

H H H H L H H_ H Transmitter Buffer 

H H H L H H H_ H Interval Timer 4 

H H H H H H H _ H Interval Timer 5 or X17 
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The following paragraphs define the functions of the TMS 5501 commands. 


2.2.1 Read receiver buffer 
Addressing the read-receiver-buffer function causes the receiver buffer contents to be transferred to the TMS 8080 and 
clears the receiver-buffer-loaded flag. 


2.2.2 Read external input lines 
Addressing the read-external-inputs function transfers the states of the eight external input lines to the TMS 8080. 


2.2.3 Read interrupt address 
Addressing the read interrupt address function transfers the current highest priority interrupt address onto the data bus 
as read data. After the read operation is completed, the corresponding bit in the interrupt register is reset. 


If the read-interrupt-address function is addressed when there is no interrupt pending, a false interrupt address will be 
read. TMS 5501 status function should be addressed in order to determine whether or not an interrupt condition is 
pending. 

2.2.4 Read TMS 5501 status 


Addressing the read-TMS 5501-status function gates the various status conditions of the TMS 5501 onto the data bus. 
The status conditions, available as indicated in Figure 3, are described in the following paragraphs. 


BIT: 


DETECT | DETECT 


FIGURE 3—DATA BUS ASSIGNMENTS FOR TMS 5501 STATUS 


Bit 0, framing error 

A high in bit 0 indicates that a framing error was detected on the last character received (either one or both stop bits 
were in error). The framing error flag is updated at the end of each character. Bit O of the TMS 5501 status will remain 
high until the next valid character is received. 


Bit 1, overrun error 
A high in bit 1 indicates that a new character was loaded into the receiver buffer before a previous character was read 
out. The overrun error flag is cleared each time the read-!/O-status function is addressed or a reset command is issued. 


Bit 2, serial received data 


Bit 2 monitors the receiver serial data input line. This line is provided as a status input for use in detecting a break and 
for test purposes. Bit 2 is normally high when no data is being received. 


Bit 3, receiver buffer loaded 

A high in bit 3 indiciates that the receiver buffer is loaded with a new character. The receiver-buffer-loaded flag remains 
high until the read-receiver-buffer function is addressed (at which time the flag is cleared). The reset function also clears 
this flag. 


2.2.5 


Bit 4, transmitter buffer empty 
A high in bit 4 indicates that the transmitter buffer register is empty and ready to accept a character. Note, however, 
that the serial transmitter register may be in the process of shifting out a character. The reset function sets the 


-transmitter-buffer-empty flag high. 


Bit 5, interrupt pending 
A high in bit 5 indicates that one or more of the interrupt conditions has occured and the corresponding interrupt is 
enabled. This bit is the status of the interrupt signal INT. 


Bit 6, full bit detected 
A high in bit 6 indicates that the first data bit of a receive-data character has been detected. This bit remains high until 
the entire character has been received or until a reset is issued and is provided for test purposes. 


Bit 7, start bit detected 
A high in bit 7 indicates that the start bit of an incoming data character has been detected. This bit remains high until 


the entire character has been received or until a reset is issued and is provided for test purposes. 


Issue discrete commands 


Addressing the discrete command function causes the TMS 5501 to interpret the data bus information according to the 
following descriptions. See Figure 4 for the discrete command format. Bits 1 through 5 are latched until a different 


discrete command is received. 
NORMALLY LOW 


—_—_-—_— 


BIT: 7 6 = 4 3 2 1 0 
NOT NOT TEST TEST ae INT. 7 
ACK. BREAK | RESET 
USED USED BIT BIT ENABLE SELECT | 
H: Enables interrupt acknowledge H: Reset 
L: Inhibits interrupt acknowledge 3 LL: No action 
H: Selects XI 7 — H: L Sets XMT output low 
L: Selects interval timer 5 L: H Sets XMT output high 


FIGURE 4—DISCRETE COMMAND FORMAT 


Bit O, reset 

A high in bit O will cause the following: 

1) The receiver buffer and register are cleared to the search mode including the receiver-buffer-loaded flag, the 
start-bit-detected flag, the full-bit-detected flag, and the overrun-error flag. The receiver buffer is not cleared and 
will contain the last character received. | 


2) The transmitter data output is set high (marking). The transmitter-buffer-empty flag is set high indicating that the 
transmitter buffer is ready to accept a character from the TMS 8080. 


3) The interrupt register is cleared except for the bit corresponding to the transmitter buffer interrupt, which is set 
high. 


~ 4) The interval timers are inhibited. 


A low in bit O causes no action. The reset function has no affect on the output port, the external inputs, interrupt 
acknowledge enable, the mask register, the rate register, the transmitter register, or the transmitter buffer. 


Bit 1, break 
A low in bit 1 causes the transmitter data output to be reset low (spacing). 


If bit O and bit 1 are both high, the reset function will override. 


Bit 2, interrupt 7 select 
Interrupt 7 may be generated either by a low to high transition of external input 7 or by interval timer 5. 


A high in bit 2 selects the interrupt 7 source to be the transition of external input 7. A low in bit 2 selects the 
interrupt 7 source to be interval timer 5. 


Bit 3, interrupt acknowledge enable 
The TMS 5501 decodes data bus (CPU status) bit O at SYNC of each machine cycle to determine if an interrupt 


acknowledge is being issued. 


A high in bit 3 enables the TMS 5501 to accept the interrupt acknowledge decode. A low in bit 3 causes the TMS 5501 
to ignore the interrupt acknowledge decode. 


Bit 4 and bit 5 are used only during testing of the TMS 5501. For correct system operation both bits must be kept low. 
Bit 6 and bit 7 are not used and can assume any value. 
2.2.6 Load rate register 


Addressing the load-rate-register function causes the TMS 5501 to load the rate Regiore from the data bus and interpre? 
the data bits (See Figure 5) as follows. 7 J 7 


0 
ee a rae s on = 110 
BIT(s) . baud baud baud baud : baud baud 


H: One stop bit 
L: Two stop bits 


BIT: 


FIGURE 5—DATA BUS ASSIGNMENTS FOR RATE COMMANDS 


Bits 0 through 6, rate select 


The rate select bits (bits 0 through 6) are mutually exclusive, i.e., only one bit may be high. A high in bits 0 through 6 
will select the baud rate for both the transmitter and receiver circuitry as defined below and in Figure 5: 


Bit O 110 baud 
Bit 1 150 baud 
Bit2 300 baud 
Bit 3 1200 baud 
Bit 4 2400 baud 
Bit5 4800 baud 
Bit6 9600 baud 


If more than one bit is high, the highest rate indicated will result. !f bits 0 through 6 are all low, both the receiver and 
the transmitter circuitry will be inhibited. 


Bit 7, stop bits 


Bit 7 determines whether one or two stop bits are to be used by both the transmitter and receiver circuitry. A high in 
bit 7 selects one stop bit. A low in bit 7 selects two stop bits. 


2.2.7 Load transmitter buffer 


Addressing the load-transmitter-buffer function transfers the state of the data bus into the transmitter buffer. 


2.2.8 Load output port 


Addressing the load-output-port function transfers the state of the data bus into the output port. The data is latched 
and remains on XO O through XO 7 as the complement of the data bus until new data is loaded. 


2.2.9 Load mask register 


Addressing the load-mask-register function loads the contents of the data bus into the mask register. A high in data bus 
bit n enables interrupt n. A low inhibits the corresponding interrupt. 


2.2.10 Load timer n 


3.1 


Addressing the load-timer-n function loads the contents of the data bus into the appropriate interval timer. Time 
intervals of from 64 us (data bus = LLLLLLLH) to 16,320 us (data bus HHHHHHHH) are counted in 64-us, steps. 
When the count of interval timer n reaches O, the bit in the interrupt register that corresponds to timer nis set and 
an interrupt is generated. Loading a!! lows causes an interrupt immediately. 


TMS 5501 ELECTRICAL AND MECHANICAL SPECIFICATIONS 


ABSOLUTE MAXIMUM RATINGS OVER OPERATING FREE-AIR TEMPERATURE RANGE 
(UNLESS OTHERWISE NOTED)* | ; 


Supply voltage, Vcc (see Note 1) 2. 2... ee eee ee 60.3 V to 20 V 
Supply voltage, Vpp (see Note 1 bide OO Oe A A woe oe BRS ee oe Yow a. BOSVitEe 20 V 
Supply voltage, Vgg (see Note1) 2... 2. ee ee ee, 0.3 V to 20 V 
All input and output voltages (see Note 1) . 2. 2... ee . )60.3 V to 20 V 
CONTINUOUS POWEr GISSIPATION. 2.4. goa a &S me ee a we eH a be tee ch 
Operating free-air temperature range... . 1. ee ee ee ee ee ee ew ye 60°C to 70°C 
Storage temperature range 2... ww —65°C to 150°C 


“Stresses beyond those listed under ‘‘Absolute Maximum Ratings’’ may cause permanent damage to the device. This is a stress rating only 
and functional operation of the device at these or any other conditions beyond those indicated in the ‘‘Recommended Operating 
Conditions” section of this specification is not implied. Exposure to absolute-maximum-rated conditions for extended periods may affect 
device reliability. 


NOTE 1: Under absolute maximum ratings voltage values are with respect to the normally most negative supply voltage, VBB (substrate), 


Throughout the remainder of this data sheet, voltage values are with respect to Vss unless otherwise noted. 


3.2 RECOMMENDED OPERATING CONDITIONS 


Supply voltage, Vag 4.75 -5 —5,.25 


Supply voltage, Voc | 475 5 5.25 


Supply voltage, Vpp ; 11.4 


Low-level clock input voltage, Vj __(@) (see Note 2) 


Operating free-air temperature, Ta 


NOTE 2: The algebraic convention where the most negative limit is designated as minimum is used in this specification for logic voitage levels only. 
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3.5 SWITCHING CHARACTERISTICS OVER FULL RANGE OF RECOMMENDED 
OPERATING CONDITIONS (SEE FIGURES 6 AND 7) 


PARAMETER TEST CONDITIONS | MIN MAX | UNIT 


tpZz™x Data bus output enable time 200] ns 
— Cy = 100 pF, | 
tPxZ Data bus output disable time to high-impedance state 180 ns 
Rp = 1.3 kQ 
tpp External data output propagation delay time from 2 200 
3 V 
Ry_ = 1.3 kQ 
TMS 5501 
OUTPUT 
C;, includes probe and jig capacitance 
LOAD CIRCUIT 
sl) —~ fe tt) 
| | { | 
ne ee ee rel — l weg a 2) 
$1 | | 


I | | tw(p2) +> | trig) > as be-tH(0 


| 
2 td(o1H-62) +f~=—_____—___— > td (02-91) : | 
—$__—__§_—__——— I 
tsu (CE) —e———om th(CE)-~e——ol | | 


| 
CHIP S 
| | 


CK xX S/S , oS <x xX CP KS —Vaw, ww VaVav, xxK™ xx xx SX xX 7S) Oe wy, 
ENABLE XY | ROP RI ONT ABER 00 SE RI ROIS 


D1 


IOKRKDON T CARECREKRKKR K]___OUTPUTDATAVALID. SC 
D207 SBRRSXDON T CARE Re | __ OUTPUT DATA VALID 2 
kee} tsu (ad) e—_——e!—th (ad) 

A0-A3 OS DON'T CARE XS 

CX XK ADADRANKAAKNK 

EX ERN FS ON aN ON ON ON NG ha ONG oO ONO OG, A777 AW A PRR 
oe ERE K KKK DONT CAREC KKH KK 

INPUTS CX KKK KK (NL LNANOD xX KKKKKXK 


NOTE: For@1 or @2 inputs, high and low timing points are 90% and 10% of VIiH(d)- Allother timing points are the 50% level. 


FIGURE 6—READ CYCLE TIMING 


o2 | | | | 
[ 
tsu(CE)--——} be————t- th (CE) ! | 
C H | Pp \¢ Sx KK J << * DON'T CAREX KKK KK KOKORO 
ENABLE Soxey ! RRR OT CA RE OR RRR 
| 
I | l | 
SYNC | | 
| | | t +», t le a 
D0, 1 Cs BRR RRIK INPUT DATA | RRS See 
D2 DT SSSR DONT CARE SSCS 5505 Poo 
t t | 
— su (ad) h(ad)-¢—__—-» SOSOBBOOS 
A0-A3 MPM, x 
tPD—fg——__—_-oI 
EXTERNAL 1 
OUTPUTS PREVIOUS EXTERNAL OUTPUT DATA NEW DATA 


NOTE: For $1 and $2 inputs, high and low timing points are 90% and 10% of VIiH(d). All other timing points are the 50% level. 


FIGURE 7—WRITE CYCLE TIMING 


fe twi(sens H}-ete—tw(sens Lt 


SENSOR 4 Ye x 
1 


M$ ( sens-int) ——#! 


! 
INTERRUPT 7x a 


| 
RST INSTRUCTION be— ta(rst-int) a4 
ON DATA BUS af 
(See Note 1) 


NOTES: 1. The RST instruction occurs during the output data valid time of tne read cycle. 
2. All timing points are 50% of Viz. 


FIGURE 8—SENSOR/INTERRUPT TIMING 
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TMS 8080 MICROPROCESSOR 


1. ARCHITECTURE 
1.1 INTRODUCTION 


The TMS 8080 is an 8-bit paralle! central processing unit (CPU) fabricated on a single chip using a high-speed N-channel 
silicon-gate process. (See Figure 1). A complete microcomputer system with a 2-us instruction cycle can be formed by 
interfacing this circuit with any appropriate memory. Separate 8-bit data and 16-bit address buses simplify the interface 
and allow direct addressing of 65,536 bytes of memory. Up to 256 input and 256 output ports are also provided with 
direct addressing. Control signals are brought directly out of the processor and all signals, excluding clocks, are TTL 
compatible. 


1.2 THE STACK 


The TMS 8080 incorporates a stack architecture in which a portion of external memory is used as a pushdown stack for 
storing data from working registers and internal machine status. A 16-bit stack pointer (SP) is provided to facilitate 
stack location in the memory and to allow almost unlimited interrupt handling capability. The CALL and RST (restart) 
instructions use the SP to store the program counter (PC) into the stack. The RET (return) instruction uses the SP to 
acquire the previous PC value. Additional instructions allow data from registers and flags to be saved in the stack. 


1.3. REGISTERS 
The TMS 8080 has three categories of registers: general registers, program control registers, and internal registers. The 
general registers and program control registers are listed in Table 1. The internal registers are not accessible by the 


programmer. They include the instruction register, which holds the present instruction, and several temporary storage 
registers to hold internal data or latch input and output addresses and data. 
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THE ARITHMETIC UNIT 


Arithmetic operations are performed in an 8-bit parallel arithmetic unit that has both binary and decimal capabilities. 
Four testable internal flag bits are provided to facilitate program control, and a fifth flag is used for decimal 
corrections. Table 2 defines these flags and their operation. Decimal corrections are performed with the DAA 
instruction. The DAA corrects the result of binary arithmetic operation on BCD data as shown in Table 3. 


STATUS AND CONTROL 


Two types of status are provided by the TMS8080. Certain status is indicated by dedicated control lines. Additional 
status is transmitted on the data bus during the beginning of each instruction cycle (machine cycle). Table 4 indicates 
the pin functions of the TMS8080. Table 5 defines the status information that is presented during the beginning of each 
machine cycle (SYNC time) on the data bus. 


I/O OPERATIONS 


Input/output operations (1/O) are performed using the IN and OUT instructions. The second byte of these instructions 
indicates the device address (256 device addresses). When an IN instruction is executed, the input device address 
appears in duplicate on A7 through AO and A115 through A8, along with WO and INP status on the data bus. The 
addressed input device then puts its input data on the data bus for entry into the accumulator. When an OUT 
instruction is executed, the same operation occurs except that the data bus has OUT status and then has output data. 


Direct memory access channels (DMA) can be OR-tied directly with the data and address buses through the use of the 
HOLD and HLDA (hold acknowledge) controls. When a HOLD request is accepted by the CPU, HLDA goes high, the 
address and data lines are forced to a high-impedance or ‘“‘floating’ condition, and the CPU stops until the HOLD 
request is removed, 


Interfacing with different speed memories is easily accomplished by use of the WAIT and READY pins. During each 
machine cycle, the CPU polls the READY input and enters a wait condition until the READY line becomes true. When 
the WAIT output pin is high, it indicates that the CPU has entered the wait state. 


Designing interrupt driven systems is simplified through the use of vectored interrupts. At the end of each instruction, 
the CPU polls the INT input to determine if an interrupt request is being made. This action does not occur if the CPU is in 
the HOLD state or if interrupts are disabled. The INTE output indicates if the interrupt logic is enabled (INTE is high). 
When a request is honored, the INTA status bit becomes high, and an RST instruction may be inserted to force the CPU 
to jump to one of eight possible locations. Enabling or disabling interrupts is controlled by special instructions (El or 
DI). The interrupt input is automatically disabled when an interrupt request is accepted or when a RESET signal is 
received, 


INSTRUCTION TIMING 


The execution time of the instructions varies depending on the operation required and the number of memory 
references needed. A machine cycle is defined to be amemory referencing operation and is either 3,4, or 5 state times 
long. A state time (designated S) is a full cycle of clocks @1 and $2. (NOTE: The exception to this rule is the DAD 
instruction, which consists of 1 memory reference in 10 state times). The first machine cycle (designated M1) is either 4 
or 5 state times long and is the “instruction fetch” cycle with the program counter appearing on the address bus. The 
CPU then continues with as many M cycles as necessary to complete the execution of the instruction (up to a 
maximum of 5). Thus the instruction execution time varies from 4 state times (several including ADDr) to 18 (XTHL). 
The WAIT or HOLD conditions may affect the execution time since they can be used to control the machine (for 
example to “‘single step’’) and the HALT instruction forces the CPU to stop until an interrupt is received. As the 
instruction execution is completed (or in the HALT state) the INT pin is polled for an interrupt. In the event of an 
interrupt, the PC will not be incremented during the next M1 and an RST instruction can be inserted. 
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TABLE 1 
TMS 8080 REGISTERS 


NAME DESIGNATOR LENGTH PURPOSE 
Accumulator A 8 Used for arithmetic, logical, and !/O operations 
B Register | B 8 General or most significant 8 bits of double register BC 
C Register C 8 General or least significant 8 bits of double register BC 
D Register D 8 General or most significant 8 bits of double register DE 
E Register E 8 General! or least significant 8 bits of double register DE 
H Register H 8 General or most significant 8 bits of double register HL 
L Register E 8 General or least significant 8 bits of double register HL 
Program Counter PC 16 | Contains address of next byte to be fetched 
Stack Pointer SP 16 Contains address of the last byte of data saved in 

the memory stack 

Flag Register F 5 Five flags (C, Z, S, P, C1) 


NOTE: Registers B and C may be used together as a single 16-bit register, likewise, D and E, and H and L. 


TABLE 2 


FLAG DESCRIPTIONS 


SYMBOL TESTABLE DESCRIPTION 

C C is the carry/borrow out of the MSB (most significant bit) of the ALU (Arithment Logic 
Unit). A TRUE condition (C= 1) indicates overflow for addition or underflow for 
subtraction. 

Z A TRUE condition (Z = 1) indicates that the output of the ALU is equal to zero. 

S A TRUE condition (S = 1) indicates that the MSB of the ALU output is equal to a one (1). | 

P A TRUE condition (P =1) indicates that the output of the ALU has even parity (the 
number of bits equal to one is even). 

C1 C1 is the carry out of the fourth bit of the ALU (TRUE condition). C1 is used only for BCD 


correction with the DAA instruction. 


TABLE 3 
FUNCTION OF THE DAA INSTRUCTION 


Assume the accumulator (A) contains two BCD digits, X and Y 


7 4 3 0 


ACC Y 


ACCUMULATOR 
AFTER DAA 


- Oo - Oo Oo -—- O CO 


0 
0 
0 
1 
1 
1 
0 
0 
0 


NOTE: The corrections shown in Table 3 are sufficient for addition. For subtraction, the programmer must account for the borrow 


condition that can occur and give erroneous results. The most straight forward method is to set A = 9946 and carry = 1. Then 
add the minuend to A after subtracting the subtrahend from A. 
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TABLE 4 
TMS 8080 PIN DEFINITIONS 


SIGNATURE} PIN- 1/O DESCRIPTION 

A15 (MSB) 36 OUT A15 through AO comprise the address bus. True memory or 1/O device addresses appear on 

A14 39 OUT this 3-state bus during the first state time of each instruction cycle. 

A13 38 OUT 

A12 37 OUT 

All 40 OUT 

A10 1 OUT 

AQ 30 OUT 

A8 34 OUT 

A7 33 OUT 

A6 32 OUT 

Ad 31 OUT 

A4 30 OUT 

A3 29 OUT 

A2 27 OUT 

Al 26 OUT 

AO (LSB) 25 OUT 

D7 (MSB) 2 IN/OUT D7 through DO comprise the bidirectional 3-state data bus. Memory, status, or !/O data is 

D6 5 IN/OUT ; 
transferred on this bus. 

D5 4 IN/OUT 

D4 3 IN/OUT 

D3 7 IN/OUT 

D2 8 IN/OUT 

D1 9 IN/OUT 

DO (LSB) 10 IN/OUT 

Vss 2 Ground reference 

VeB 11 Supply voltage (--5 V nominal) 

Vcc 20 Supply voltage (5 V nominal) 

VDD 28 Supply voltage (12 V nominal) 

pi 22 IN Phase 1 clock. 

2 15 IN Phase 2 clock. See page 19 for #1 and $2 timing. 

RESET 12 IN Reset. When active (high) for a minimum of 3 clock cycles, the RESET input causes the 
TMS 8080 to be reset. PC is cleared, interrupts are disabled, and after RESET, instruction 
execution starts at memory location 0. To prevent a lockup condition, a HALT instruction 
must not be used in location O. 

HOLD 13 IN Hold signal. When active (high) HOLD causes the TMS 8080 to enter a hold state and float 
(put the 3-state address and data bus in a high-impedance state). The chip acknowledges 
entering the hold state with the HLDA signal and will not accept interrupts until it leaves 
the hold state. 

INT 14 iN Interrupt request. When active (high) INT indicates to the TMS8080 that an interrupt is 
being requested. The TMS8080 polls INT during a HALT or at the end of an instruction. 
The request will be accepted except when INTE is low or the CPU is in the HOLD 
condition. 

INTE 16 OUT Interrupts enabled. INTE indicates that an interrupt will be accepted by the TMS 8080 
unless it is in the hold state. INTE is set to a high logic level by the E! (Enable Interrupt) 
instruction and reset to a low logic level by the DI (Disable Interrupt) instruction. INTE is 
also reset when an interrupt is accepted and by a high on RESET. 

DBIN 17 OUT Data bus in. DBIN indicates whether the data bus is in an input or an output mode. 


(high = input, low = output), 
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2. 


2.1 


TABLE 4 (CONTINUED) 


DESCRIPTION 


SIGNATURE 


Write. When active (low) WR indicates a write operation on the data bus to memory or to an 
1/O port. 


OUT Synchronizing control line. When active (high) SYNC indicates the beginning of each 


SYNC 
machine cycle of the TMS 8080. Status information is also present on the data bus during 
SYNC for external latches. 
HLDA OUT Hold acknowledge. When active (high) HLDA indicates that the TMS 8080 Is in a hold state. 
READY IN Ready control line. An active (high) level indicates to the TMS 8080 that an external device 
has completed the transfer of data to or from the data bus. READY is used in conjunction 
with WAIT for different memory speeds. 
WAIT OUT Wait status. When active (high) WAIT indicates that the TMS8080 has entered a wait state 
pending a READY signal from memory. 
TABLE 5 
TMS 8080 STATUS 
SIGNATURE | DATA BUS BIT DESCRIPTION 
Interrupt acknowledge. 
WO Indicates that current machine cycle will be a read (input) (high = read) or a write (output) 
(iow = write) operation. 
STACK Indicates that address is stack address from the SP. 
HLTA HALT instruction acknowledge. 
OUT Indicates that the address bus has an output device address and the data bus has output 
data. 
M1 Indicates instruction acquisition for first byte. 
INP Indicates address bus has address of input device. 
MEMR Indicates that data bus will be used for memory read data. 


TMS 8080 INSTRUCTION SET 


INSTRUCTION FORMATS 


TMS 8080 instructions are either one, two, or three bytes long and are stored as binary integers in successive memory 
locations in the format shown below. 


One-Byte Instructions 


D7 D6 D5 D4 D3 D2 D1 DO OP CODE 


Two-Byte Instructions 


D7 D6 D5 D4 D3 D2 D1 DO OP CODE 


D7 D8 D5 D4 D3 D2 D1 DO OPERAND 


Three-Byte Instructions 
D7 D6 D5 D4 D3 D2 D1 DO OP CODE 


D7 D6 D5 D4 D3 D2 D1 DO LOW ADDRESS OR OPERAND 1 


D7 D6 D5 D4 D3 D2 D1 DO HIGH ADDRESS OR OPERAND 2 


2.2 INSTRUCTION SET DESCRIPTION 


Operations resulting from the execution of TMS 8080 instructions are described in this section. The flags that are affected by 
each instruction are given after the description. 


2.2.1 INSTRUCTION SYMBOLS 


SYMBOL DESCRIPTION 
<b2> Second byte of instruction 
<b3> Third byte of instruction 
rg Register # Register Name 
000 B 
001 C 
010 D 
011 E 
100 H 
101 L 
111 A 
rb Register # Register Name 
00 BC 
01 DE 
10 HL 
11 SP 
rc Register # Register Name 
0 BC 
1 DE 
rd Register # Register Name 
00 BC 
01 DE 
10 HL 
rd Least significant 8 bits of rq 
rdH Most significant 8 bits of rq 
f Flags True condition 
Zero (Z) Result is zero 
Carry (C) Carry/borrow out of MSB is one 
Parity (P) Parity of result is even 
Sign (S) MSB of result is one 
Carry 1(C1) Carry out of fourth bit is one 


M Memory address defined by registers H and L 

( ) Contents of specified address or register 

[ ] Contents at address contained in specified register 
= Is transferred to 


< Exchange 
Am Bit m of A register (accumulator) 
} | Flags affected 
b9 Single byte immediate operand 
b3b2 Double byte immediate operand 
(nnn)g (nnn) is an octal (base 8) number 
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2.2.2 ACCUMULATOR GROUP INSTRUCTIONS 


MNEMONIC 


ACI 


ADC 
ADC 
ADD 


ADD 
ADI 
ANA 


ANA 
ANI 
CMA 
CMC 
CMP 


CMP 
CPI 
DAA 


RRC 


OPERANDS 


b2 


Ya 
b2 


Va 
b2 


BYTES 


2 


—=— — =» AQ « 


M CYCLES/ 


STATES 


2/7 


2/7 
1/4 
2/7 


1/4 
2/7 
2/7 


1/4 
2/7 
1/4 
1/4 
2/7 


1/4 
2/7 
1/4 


1/10 


4/13 
2/7 
2/7 


1/4 
2/7 
1/4 


1/4 
1/4 


1/4 


DESCRIPTION 
(A) (A) + <b 9>+(carry), add the second byte of the 
instruction and the contents of the carry flag to register A and 
place in A. {C,Z,S,P,C1 t 


(A) — (A) + (M) + (carry). | C,Z;S,P,C1 } 

(A) < (A) + (rg) + (carry). C,Z,S,P,C1 } 

(A) + (A) + (M), add the contents of M to register A and place in 
A. {C,Z,S,P,C1} 


(A) < (A) + (rg).4C,Z,S,P,C1 | 


(A) — (A) + <bg>. $C,Z,S,P,C1} 
(A) — (A) AND (M), take the logical AND of M and register A 
and place in A. The carry flag will be reset low. }C,Z,S,P,C1} 
(A) — (A) AND (rg). {C,Z,S,P,C1} 
(A) — (A) AND <bg>. {C,Z,S,P,C1} 
(A) — (A), complement A. 
(carry) <— (carry), complement the carry flag. \C t 
(A) — (M), compare the contents of M to register A and set the 
flags accordingly. | C,Z,S,P,C1} 

(A)=(M) Z=1 

(A)#(M) Z=0 

(A)<(M) C#1 

(A)>(M) C#=0 
(A) — (ra). {C,Z,S,P,C1} 
(A)—<bg>. {C,Z,S,P,c1} 
(A)<-BCD correction of (A). The 8 bit A contents is corrected to 
form two 4 bit BCD digits after a binary arithmetic operation. A 
fifth flag C1 indicates the overflow from A3. The carry flag C 
indicates the overflow from A7 (See Table 3). {C,Z,S,P,C1 t 
(HL) < (HL) + (rp), add the contents of double register rp, to 
double register HL and place in HL. ic} 
(A)<[<b3> <b9>] 
(A)<[(re)] 
(A) < (A) OR (M), take the logical OR of the contents of M and 
register A and place in A. The carry flag will be reset. 
1C,Z,S,P,C1} 
(A) <— (A) OR (rg).{C,Z,S,P,C1} 
(A) — (A) OR <b>. }C,Z,S,P,C1} 
Am+1<Am, Agc(carry), (carry)(A7). Shift the contents of 
register A to the left one bit through the carry flag. ic 
AmAm+1, Azc(carry), (carry)—Ag.{C } 
Am+1<Am, AgA7 (carry)<(A7). Shift the contents of register 
A to the left one bit. Shift Az into A and into the carry 
flag. {C$ , 
AmAm+1, A7Ao, (carry)—(Ag). {C | 


M CYCLES/ 


MNEMONIC OPERANDS BYTES STATES 
SBB M 1 2/7 
SBB lq 1 1/4 
SBI b2 2 2/7 
STA b3b9 3 4/13 
STAX te 1 2/7 
STC 1 1/4 
SUB M 1 2/7 
SUB fe 1 1/4 
SUI b2 2 2/7 
XRA M 1 2/7 
XRA rg 1 1/4 
XRI bo 2 2/7 
2.2.3 INPUT/OUTPUT INSTRUCTIONS 
MCYCLES/ 
MNEMONIC OPERANDS BYTES STATES 
IN bo 2 3/10 
OUT b9 2 3/10 
2.2.4 MACHINE INSTRUCTIONS 
M CYCLES/ 
MNEMONIC OPERANDS BYTES STATES 
HLT 1 2/7 
NOP 1 1/4 


DESCRIPTION 


(A)—(A)—(M)—(carry), subtract the contents of M and the 
contents of the carry flag from register A and place in A. Two's 
complement subtraction is used and a true borrow causes the 
carry flag to be set (underflow condition). |C,Z,S,P,C1} 
(A)<(A)—(rg)—(carry). {C,Z,S,P,C1} 

(A)(A)—<b9>—(carry). {C,Z,S,P,C1} 

[<b3> <b g>]<(A), store contents of A in memory address 
given in bytes 2 and 3. | 

[(r.)] (A), store contents of A in memory address given in BC 
or DE. 


(carry)<1, set carry flag to a 1 (true condition). 


(A)<—(A)—(M), subtract the contents of M from register A and 

place in A. Two’s complement subtraction is used and a true 

borrow causes the carry flag to be set (underflow condition). 

{C,Z,S,P,c1} 

(A)<(A)—(rg),4 C,Z,S,P,C1} 

(A)—(A)—<b2>. {C,Z,S,P,C1} 

(A)—(A) XOR (M), take the exclusive OR of the contents of M 

and register A and place in A. The carry flag will be reset. 
{C,Z,S,P,C1} 

(A)—(A) XOR (rg). {C,Z,S,P,C1} 

(A)-(A) XOR <b9>. {C,Z,S,P,C1 


DESCRIPTION 
(A)<(input data from data bus), byte 2 is sent on bits A7-AO 
and A15-A8 as the input device address. INP status is given on 
the data bus. 
(Output data)<(A), byte 2 is sent on bits A7-AO and A15-A8 as 
the output device address. OUT status is given on the data bus. 


DESCRIPTION 
Halt, all machine operations stop. All registers are maintained. 
Only an interrupt can return the TMS 8080 to the run mode, 
Note that a HLT should not be placed in location zero, 


otherwise after the reset pin is active, the TMS 8080 will enter a 
nonrecoverable state (until power is removed), i.e., in halt with 


interrupts disabled. This condition also occurs if a HLT is 
executed while interrupts are disabled. HLTA status is given on 
the data bus. 

(PC)<—(PC)+1, no operation. 


2.2.5 PROGRAM COUNTER AND STACK CONTROL INSTRUCTIONS 


MNEMONIC 


CALL 


Conditional call instructions for true flags: 


(f) 
CC (carry) 
CPE (parity) 
CM (sign) 
C2 (zero) 


Conditional call instructions for false flags: 


(f) 


CNC (carry) 
CPO (parity) 
CP (sign) 
CNZ (zero) 
DI 
E\ 
JMP 


Conditional jump instructions for true flags: 


(f) 
JC (carry) 
JPE (parity) 
JM = (sign) 
JZ (zero) 


Conditional jump instructions for false flaas: 


(f) 
JNC (carry) 
JPO (parity) 
JM = (sign) 
JNZ (zero) 
PCHL 
POP 


POP 
PUSH 


PUSH 
RET 


OPERANDS 


b3b2 


b3b2 
b3b2 
b3b2 
b3b2 


b3b9 
b3b9 


b3b9 
b3b9 


b3b2 


b3b2 
b3b2 
b3b9 
b3b2 


b3b2 
b3b2 
b3b2 
b3b2 


PSW 


rd 
PSW 


rd 


BYTES 


3 


OO W WwW 


3 


Ww WO W 


3 


-~— -—- WW WwW WwW 


-MCYCLES/ 
STATES 


5/17 


5/17 (Pass) 
3/11 (Fail) 


5/17 (Pass) 
3/11 (Fail) 


1/4 


3/10 


3/10 


3/10 


1/5 
3/10 


3/10 
3/11 


3/11 
3/10. 


D-10 


DESCRIPTION 
[((SP)—1] [(SP)—2]—(PC), (SP)<(SP)—2, (PC)<<b3> <b>, 
transfer PC to the stack address given by SP, decrement SP 


twice, and jump unconditionally to address given in bytes 2 and 
3: 


lf (f) = 1, ((SP)—1] [(SP)—2]~-(PC), (SP)<(SP)—2, (PS)+<b3> 
<b2>, otherwise (PC)<(PC)+3. If the flag specified, f, is 1, then 


execute a call. Otherwise, execute the next instruction. 


lf (f) =O, [(SP)—1] [(SP)—2] —(PC), (SP)<(SP)—2, (PC)—<b3> 
<b9>, otherwise (PC)<(PC)+3. 


Disable interrupts. INTE is driven false to indicate that no 
interrupts will be accepted. 

Enable interrupts. INTE is driven true to indicate that an 
interrupt will be accepted. Execution of this instruction is 


delayed to allow the next instruction to be executed before the 


INT input is polled. 


(PC)«<b3> <b>, jump unconditionally to address given in 
bytes 2 and 3. 


If (f) = 1, (PC)<<b3><b >, otherwise (PC)<-(PC)+3. If the flag 
specified, f, is 1, execute a JMP. Otherwise, execute the next 


instruction. 


If (f)=0, (PC)<<b3> <b>, othewise (PC)<(PC)+3. 


(PC)<(HL) 

(F)<[(SP)], (A)<-[(SP)+1], (SP)<(SP)+2, restore the last 
stack values addressed by SP into A and F. Increment SP twice. 
(rgu)L(SP)], (rgH)<[(SP)+1] , (SP)<-(SP)+2. 

[(SP)—1]<(A), [(SP)—2]<(F), (SP)<(SP)—2, save the contents 
of A and F into the stack addressed by SP. Decrement SP twice. 
[(SP)—1]<(rgp), [(SP)—2] -(rgH), (SP)<(SP)—2. 

(PC)<[(SP)] [(SP)+1], (SP)<-(SP)+2, return to program at 
memory address given by last values in the stack. The SP is 


incremented by two. 


M CYCLES/ 
MNEMONIC OPERANDS BYTES STATES 


Conditional return instructions for true flags: 


(f) 3/11 (Pass) 
RC (carry) C 1 1/5 (Fail) 
RPE (parity) P 1 
RM (sign) S 1 
RZ (zero) Z 1 
Conditional return instructions for false flags: 

(f) 3/11 (Pass) 
RNC (carry) C 1 1/5 (Fail) 
RPO (parity) P 1 
RP (sign) S 1 
RNZ (zero) Zz 1 

RST 1 3/11 


SPHL 1 1S 


2.2.6 REGISTER GROUP INSTRUCTIONS 


M CYCLES/ 
MNEMONIC OPERANDS BYTES STATES 
DCR M 1 3/10 
DCR rg 1 1/5 
DCX 'b 1 1/5 
INR M 1 3/10 
INR rg 1 1/5 
INX 'b 1 1/5 
LHLD b3b2 3 5/16 
LX1 rpb3b2 3 3/10 
MVI M,b2 2 3/10 
MMVI rab? 2 Py 
MOV rgM 1 2/7 
MOV ala? 1 kD 
SHLD b3b9 3 5/16 
XCHG 1 1/4 
XTHL 1 5/18 


DESCRIPTION 


lf (f) = 1, (PC)+-((SP)] [(SP+1], (SP)<(SP)+2. If the flag 


specified, f, is 1, execute a RET. Otherwise, execute the next 


s 


instruction. 


If (f) = O, (PC)« [(SP)] [(SP)+1], (SP)<-(SP)+2. 


[((SP)—1} [(SP)—2] «(PC) (SP)<-(SP)--2, (PC)OO000RO0g where 
R is a 3 bit field in RST (RST=3R7g). Transfer PC to the stack 
address given by SP, decrement SP twice, and jump to the 
address specified by R. 

(SP)<(HL). 


DESCRIPTION 
(M)<-(M)—1, decrement the contents of memory location 
specified by H and L. }Z,S,P,C1} 
(r4)<(rg)—1, decrement the contents of register rg. {Z,S,P,C1 { 
(rph)<-(rp)—1, decrement double registers BC, DE, HL, or SP. 
(M)<(M)+1, increment the contents of memory location 
specified by H and L.\Z,S,P,C1 | 
(r,)<-(rg)+1, increment the contents of register ra. |Z, 5,P.C1t 
(rh)<(rp)+1, increment double registers BC, DE, HL, or SP. 
(L)}—[<b3> <b >]; (H)< [<b3> <b 2>+1], load registers H 
and L with contents of the two memory locations specified 
by bytes 3 and 2. 
(rhH)<-<b3>; (rpL)<<b2>, load double registers BC, DE, HL, 
Or SP immediate with bytes 3, 2, respectively. 
(M)+<b9>, store immediate byte 2 in the address specified by 

HL 

(r4)<-<b >, load register rg immediate with byte 2 of the instruc- 
tion. 
(M)<(rg), store register rz in the memory location addressed by 
H and L. 
(r4)<-(M), load register rz with contents of memory addressed by 
HL, 
(r41)<(rg2), load register rz1 with contents of rg2, ra2 contents 
remain unchanged. 
[<b3> <b9>]<(L); [<bg> <b2>+1)]<(H), store the contents 
of H and L into two successive memory locations specified by 
bytes 3 and 2. 
(H)(D); (L)+-(E), exchange double registers HL and DE 
(L)+[(SP)], (H)-[(SP)+1], (SP)=(SP), exchange the top of the 
stack with register HL. 


2.3. INSTRUCTION SET OPCODES ALPHABETICALLY LISTED 


MNEMONIC BYTES 
ACI 2 
ADC M 1 
ADC r 1 
ADD M 1 
ADD r 1 
ADI 2 
ANAM 
ANAr 1 
ANI 2 

¢ CALL 3 
CC 3 
CM 3 
CMA 1 
CMC 1 
CMP M 1 
CMP r 1 
CNC 3 
CNZ 3 
CF 3 
CPE 3 
CPI 2 
CPO 3 
CZ 3 
DAA 1 


DESCRIPTION 
Add immediate to A with carry? 
Add memory to A with carry? 
Add register to A with carryt 


Add memory to At 
Add register to At 


Add immediate to At 
AND memory with At 
AND register with AT 


AND immediate with At 
Call unconditional 

Call on carry 

Call on minus 
Complement A 
Complement carry“: 
Compare memory with At 


Compare register with A 


Call on no carry 

Call on no zero 

Call on positive 

Call on parity even 

Compare immediate with At 
Call on parity odd 

Call on zero 


Decimal adjust At 


REGISTER 


AFFECTED 


rrermexérérimoeOo DW 


pr rm oO a 


Bi. lm OO. +o 


rPrFéomonoe 


“Two possible cycle times (11/17) indicate instruction cycles dependent on condition flags. 


TAM flags (C, Z,S, P, C1) affected, 
+Only carry flag affected. — 
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POSITIVE-LOGIC 


HEX OPCODE 
\D7—D4, \D3-—D0, 
C E 
8 E 
8 8 
8 9 
8 A 
8 B 
8 C 
8 D 
8 F 
8 6 
8 0 
8 1 
8 2 
8 3 
8 4 
8 5 
8 7 
C 6 
A 6 
A 0 
A 1 
A 2 
A 3 
A 4 
A 5 
A 7 
E 6 
C D 
D C 
F C 
2 F 
3 F 
B = 
B 8 
B 9 
B A 
B B 
B C 
B D 
B F 
D 4 
C 4 
F 4 
E C 
F E 
E 4 
C C 
2 7 


CLOCK 


CYCLES* 


7 
7 
4 


POSITIVE-LOGIC 


REGISTER HEX OPCODE CLOCK 
MNEMONIC BYTES DESCRIPTION AFFECTED D7—D4 D3—D0O CYCLES 
NEVO, fe Pee eee, Ne ee, Oe 

DAD B 1 Add B&C to H&L* 0 9 10 
DADC 1 Add D&E to H&L* 1 9 10 
DAD H 1 Add H&L to H&L? 2 9 10 
DAD SP 1 Add stack pointer to H&L* 3 9 10 
DCRM 1 Decrement Memory $ S 5 10 
DCRr 1 Decrement Register S B 0 5 5 

C 0 D 

D 1 5 

E 1 D 

H 2 5 

L Z D 

A 3 D 
DCX B 1 Decrement B&C 0 B 5 
DCX D 1 Decrement D&E 1 B 5 
DCX H 1 Decrement H&L 2 B 5 
DCX SP 1 Decrement stack pointer 3 B 5 
D| 1 Disable interrupts F 3 4 
El 1 Enable interrupts F B 4 
HLT 1 Halt 7 6 7 
IN 2 Input D B 10 
INR M 1 Increment memory § 3 4 10 
INR r 1 Increment register S B 0 4 5 

C 0 C 

D 1 4 

= 1 C 

H 2 4 

L 2 C 

A 3 C 
INX B 1 Increment B&C register 0 3 5 
INX D 1 Increment D&E register 1 3 5 
INX H 1 Increment H&L register 2 3 5 
INX SP 1 Increment stack pointer 5 3 5 
JC 3 Jump on carry D A 10 
JM 3 Jump on minus F A 10 
JMP 3 Jump unconditional C 3 10 
JNC 3 Jump on no carry D 2 10 
JNZ S! Jump on no zero C Z 10 
JP 3 Jump on positive F 2 10 
a= 3 Jump on parity even E A 10 
JPO 3 Jump on parity odd E 2 10 
JZ 3 Jump on zero c A 10 
LDA 1 Load A direct 3 A 13 
LDAX B 1 Load A indirect 0 A 7 
LDAX D 1 Load A indirect 1 A 7 
LHLD S Load H&L direct 2 A 16 
LX!IB 3 Load immediate register pair B&C 0 1 10 
LX! D 3 Load immediate register pair D&E 1 1 10 
LX1H 3 Load immediate register 2 1 10 
LX1 SP 3 Load immediate stack pointer 3 1 10 


Only carry flag affected. 
SAI flags except carry affected. 
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POSITIVE-LOGIC 
REGISTER HEX OPCODE CLOCK 
MNEMONIC BYTES DESCRIPTION _ AFFECTED \D7-D4, \D3-—D0, CYCLES 


168) 


MOV M,r 1 Move register to memory 0 7 


MOV r,M 1 Move memory to register 


Pr rm oO 0 OS hr eS mo Oo 


> 


MOV 14,19 1 Move register to register 


DnmoOnouwonwo ow 
rPrmxréMmoeOoO®D 


C,B 
on cam 
C,D 
C,E 
C,H 
mene 
CA 
D,B 
D,C . 
D,D 
D,E 
D,H 
H,L 
DA 
E,B 
E,C 
E,D 
E,E 
E,H 
E,L 
E,A 
H,B 
H,C 
H,D 
HE 


H,H 
H,L 
HA 


L,B 


NDoonnononooodvunnnuaonau46nn»naenrndanrieuoununauo»4na»fr Bb BBP HHH HRA HBP BP pPNnooonwUHM8V hf BN YNNnnanwan 
On OP WNH HP OTTO AW PAOAN TPF WH HP TO TBUVOADWP A WN OT KBWNH HP OMmMmoamMmoamoawnonais whnNn = 
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MNEMONIC BYTES 
MOV rq, V9 1 


MVIM 2 
MVtr 


NOP 1 
ORAM 1 
ORAr 1 


ORI 
OUT 
PCHL 
POP B 
POP D 
POP H 
POP PSW 
PUSH B 
PUSH D 
PUSH H 
PUSH PSW 
RAL 
RAR 

RC 

RET 
RLC 

RM 

RNC 
RNZ 

RP 


DESCRIPTION 


Move register to register (continued) 


Move immediate memory 


Move immediate register 


No operation 
OR memory with At 
OR register with At 


OR immediate with At 
Output 

H&L to program counter 

Pop register pair B&C off stack 
Pop register pair D&E off stack 
Pop register pair H&L off stack 
Pop A and flags off stack? 
Push register pair B&C 

Push register pair D&C 

Push register pair H&L on stack 
Push A and Flags on stack 
Rotate A left through carry = 
Rotate A right through carry = 
Return on carry 

Return 

Rotate A left: 

Return on minus 

Return on no carry 

Return on no zero 


Return on positive 


REGISTER 


AFFECTED 


Lc 
LD 
LE 
LH 
Lb 
L.A 
A,B 
A,C 
A,D 
A,E 
AH 
A,L 
A,A 


BS Pree mM oO OO 8 


Se fom So Oo 


“Two possible cycles times (11/17) indicate instruction cycles dependent on condition flags. 


Tall flags (C, Z, S, P, C1) affected, 
tonty carry flag affected. 
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POSITIVE-LOGIC 


HEX OPCODE 
\D7-—D4,/, \D3-—D0, 


"OA OFODMNr ON Dae eFPe TAmMmoaetntmaewvovoaonmoernht-wwowswdWdwoaeWWDaenwnNrdNner KHe—aodaoanwnnnnvntsn nv vi onannna ® 
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Oooo MmAaNwonAnaTnMmYN ooo o ae Be Bw ew O WON TO PRWBNH HK TOT OCMmMmaamama—aoaonhidwvooawpewonntntri_.ogoonw Y 


CLOCK 


CYCLES* 


MNEMONIC BYTES 


RPE 
RPO 
RRC 
RST 


—_— _| |. £4—= 


RZ 1 
SBB M 1 
SBBr 1 


SBI 
SHLD 
SPHL 
STA 
STAX B 
STAX D 
STC 
SUB M 
SUB r 


SUI 
XCHG 
XRAM 
XRAr 


— —- — AQ 


XRI 2 
XTHL 


DESCRIPTION 


Return on parity even 
Return on parity odd 
Rotate A right = 
Restart 


Return on Zero 
Subtract memory from A with borrowt 


Subtract register from A with borrow! 


Subtract immediate from A with borrow! 
Store H&L direct 

H&L to stack pointer 

Store A direct 

Store A indirect 

Store A indirect 

Set carry + 

Subtract memory from At 


Subtract register from At 


Subtract immediate from At 

Exchange D&E, H&L registers 
Exclusive OR memory with At 
Exclusive OR register with At 


Exclusive OR immediate with At 


Exchange top of stack H&L 


REGISTER 


AFFECTED 


PC<-000016 
PC<-0008 16 
PC<-001016 
PC+001846 
PC-00204 6 
PC<-00284¢ 
PC<-003016 
PC<-003816 


PP an an oO Oa 


>r- rTrMmMoOO W 


>rPrroiMmoeo Ww 


*Two possible cycles times (11/17) indicate instruction cycles dependent on condition flags. 


TAI flags (C, Z, S, P, C1) affected. 
+ Only carry flag affected. 
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POSITIVE-LOGIC 


mmpprprrprrprrprrrpremoevonendve dD DO HO HO HO WH OWTMN THO OW WOW HH HOTA HAMmMoOoDdGadnO 


HEX OPCODE 
\D7-D4, \D3-—D0/ 
E 8 
E 0 
0 F 


oOmnowoednwnwyponwmnmMmBWoan anak wWwnNneRr ODnNnNHNHNONHN MIMO OWDOMOmMoa-anaA TaN DATA 


CLOCK 


CYCLES* 


5/11 
5/11 
4 
11 


5/11 


fw PN NI 


fw HB NI 


3.1 


3.2 


3.3 


TMS 8080 ELECTRICAL AND MECHANICAL SPECIFICATIONS 


ABSOLUTE MAXIMUM RATINGS OVER OPERATING FREE-AIR TEMPERATURE RANGE 
(UNLESS OTHERWISE NOTED)* 


Supply voltage, Vcc (see Note 1). 2 ww ee eee ee 60.3 V to 20 V 
Supply voltage, Vpp (see Note 1 Be. ol Weide “Gyx dots. By Gee Uta SB ide we owe. & wd CaS. aim do ce ce. a. SOV Z0-V 
Supply voltage, Vss (see Note 1) & he Be Bh ee Bip tee, Ea we By howe EE Re a ee. SOV 1 ZO V 
All input and output voltages (see Note 1) . 2. . 2... ee ee.) 60.3 V to 20 V 
Continuous power dissipation 2... 1. wee ee ee. TL WV 
Operating free-air temperature range... we 0°C to 70°C 
Storage temperature range . 2... we —65°C to 150°C 


*Stresses beyond those listed under ‘‘Absolute Maximum Ratings’’ may cause permanent damage to the device. This is a stress rating only 
and functional operation of the device at these or any other conditions beyond those indicated in the ‘‘Recommended Operating 
Conditions’’ section of this specification is not implied. Exposure to absolute-maximum-rated conditions for extended periods may affect 
device reliability. 

NOTE 1: Under absolute maximum ratings voltage values are with respect to the normally most negative supply voltage, Veg (substrate). 

Throughout the remainder of this data sheet, voltage values are with respect to Vssg unless otherwise noted. 


RECOMMENDED OPERATING CONDITIONS 


a 


High-level input voltage, Vjy (all inputs except clocks) (see Note 2) 3.3 Vectl 


V 
V 
V 
High-level clock input voltage, VjH(¢) Vpp-1 Vopti} Vv | 
Low-level input voltage, Vj, (all inputs except clocks) (see Note 3) 


Low-level clock input voltage, Vit_(@) (see Note 3) 


Operating free-air temperature, T a 


< 


ELECTRICAL CHARACTERISTICS OVER FULL RANGE OF RECOMMENDED OPERATING CONDITIONS 
(UNLESS OTHERWISE NOTED) 


PARAMETER TEST CONDITIONS MIN TYPt MAX |UNIT 


, Input current (any input except annette : 
= to 
: clocks and data bus) | CC 


+1 
lh (go) Clock input current Vi(¢) = OV to Vpp 


li(DB) Input current, data bus Vi(pB) =9 Vto Vcc 
pias Address or data bus input Vilad) °F Vi(pB) = Yee i) 
7 current during hold Vi(ad) Or Vi(pB) =O V p= 100 | 


6075] ma 
5 10 


— 
io) 


jo) 
BAS 


uA 
UA 
LL 

HA 


uA 
© 
oO 


VOH High-level output voltage 


IOH = 100 HA 


IOL(DB) = 1-7 mA, 
IO =0.75 mA (any output except DB) 


VOL Low-level output voltage 


IBB(av) | Average supply current from Veep 
Operating at tc(g) = 480 ns, 


ICC(av) Average supply current from Vcc sees 
A= 


IDD(av) Average supply current from Vpp 


C; Capacitance, any input except clock V6éC=Vpp> Ves =0 V, 
Ci(g) Clock input capacitance Vep-—4.75to-5.25V,f=1MHz,| 5 _—10| pF 
Co Output capacitance All other pins at O V 10 20 


TAI typical values are at Ty, = 25°C and nominal voltages. 
NOTES: 2. Active pull-up resistors of nominally 2 k{2 will be switched onto the data bus when DBIN is high and the data input voltage is 
more positive than Vjyy min. 
3. The algebraic convention where the most negative limit is designated as minimum is used in this specification for logic voltage 
levels only. 
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3.4 TIMING REQUIREMENTS OVER FULL RANGE OF RECOMMENDED OPERATING CONDITIONS 
(SEE FIGURE 2) 


a TS 
te(d) Clock cycle time (see Note 5) 
tr(o) Clock rise time 
tela) Clock fall time | ns 
tw(o1) Pulse width, clock 1 high | 60 | ns 
td(61L-62) Delay time, clock 1 low to clock 2 ee Fe 
tq(62-61) Delay time, clock 2 to clock 1 
tdia4 H42) Delay time, clock 1 high to clock 2 (time between leading edges) 
tsu(da-o1) Data setup time with respect to clock 1 
tsu(da-o2) Data setup time with respect to clock 2 ae ce 
tsu(hold) Hold input setup time 
tsu lint) Interrupt input setup time 
tsu(rdy) Ready input setup time 
th(da) Data hold time (see Note 6) 

thihoigy _Holdinputhoidsime SSCS dt 
th(int) Interrupt input hold time Oe 
th(rdy) Ready input hold time ae Te 


NOTES: 5. te(i) = td(@1L-O2) + tr(@2) + tw(@2) + t#(H2) + ta(d2-01) + te(H1)- 480 ns < te(g) < 2000 ns. 
6. The data input should be enabled using the DBIN status signal. No bus conflict can then occur and the data hold time 


requirement is thus assured. 


3.5 SWITCHING CHARACTERISTICS OVER FULL RANGE OF RECOMMENDED OPERATING CONDITIONS 
(SEE FIGURE 2) 


PARAMETER 
tPD (ad) Propagation delay time, clock 2 to address outputs 


tPD(da) Propagation delay time, clock 2 to data bus Cy = 100 pF 


tPpD(cont) Propagation delay time, clocks to control outputs RL =1.3k2 


tPD(DBI) Propagation delay time, clock 2 to DBIN output 


tPD (int) Propagation delay time, clock 2 to INTE output 


Disable time to high-impedance state 


t 
anG during hold (address outputs and data bus) 


The time that the address outputs and output data will remain stable after WR goes high, twa and twp 7 td(¢1H-$2)- 
The time between address outputs becoming stable and WR going low, taw <2 to(@) —ta (1H -62)—tr(g)— 120 ns. 
The time between output data becoming stable and WR going low, tow 2 te(@) —td(@1H-@2) —tr(g)— 150 ns. 


The following are relevant when interfacing to devices requiring Vin min of 3.3 V: 


a) Maximum output rise time (tt) from 0.8 V to 3.3 V is 140 ns with C,_ as specified for the propagation delay times above. 


b) Maximum propagation delay times when measured to Vre¢(H) = 3 V (instead of 2 V) will be 60 ns more than as specified above with 
C._ as specified. 


Rp =1.3k 


T 100 pF 


C, includes probe and jig capacitance. 


TMS 8080 
OUTPUT 


LOAD CIRCUIT 


61-d 


voltage waveforms (see notes a and b) 


tc (¢) ——_—_ — > «be — td($11 2) 
tw(¢1)-4 ke i | 


I 

{ 
IN 1 | l | | | 
| : | 
\ 


’ 
1 
I tw (92) | ea i | | 
‘ | | 
IN $2 . 7 — - | 
wy) l 1 ! i | il IY |! 1] | | rr | l 
td(61H 2) ! pe—wt— th (52-41) a ' | { il : | r : ae 
| 
i 
OUT A15-A0 aaa orcoed 
tPD(ad)—e——+y , 
tPD (da) 
1/0 07-D0. ———$$$_________________+—__YF- — — — —— 4+—-—7-~ muah Sa Es Fr T 
| —™ fe teu(da-g1) | | 
DIReN NG | | be_—-plt tsu(da-o2) | 
tPD(cont)—~> <— tPD(cont) el = a | I | h 
| 
OUT DBIN 
OUT WR 
IN READY 


[| tsu(rdy 4 he-mt— tPD (cont), 


a 
tsulrdy) Heo | | | | 
t 
OUT WAIT hirdy)-tol re _| 1A | 
glia | 


tPD(cont) |\— _ | | 
IN HOLD : | Se = LS 
| th (hold —>| tPD(cont) 
! tsu(hold)—s4 beep — = am | si a - 


IN INT 
| tsu(int)—o beat ——- tsu (int) | 
| —> fe th(int) —P{ke-thlint) jg tPDIint) 
OUT INTE ee ae 
NOTES: a. This timing diagram shows timing relationships only, it does not represent any specific machine cycle. 
b. Time measurements are made at the following reference voltages: Clock, Vref(H) = 9-5 V, Vref(L) = 1 V. Other inputs, Vref(H) ~ 2 V, Vref(L) =O-8V. 
c. Data in must be stable for this period when DBIN is high during S3. Requirements for both tsu(da-61) and tsu(da-@2) Must be satisfied. 
d. The ready signal must be stable for this period during S2 or SW. This requires external synchronization. 
e. The hold signal must be stable for this period during S2 or SW when entering the hold mode and during S3, S4, S5 and SWH when in the hold mode. This requires 
external synchronization. 

f. The interrupt signal must be stable during this period on the last clock cycle of any instruction to be recognized on the following instruction. External 


synchronization is not required. 
g. During halt mode only, timing is with respect to the clock 1 falling edge. 


FIGURE 2 


3.6 TERMINAL ASSIGNMENTS 


TMS 8080 


3.7 MECHANICAL DATA 


40-PIN CERAMIC PACKAGE 


—— 2.020 MAX 


0.600 + 0.010 


0.032 NOM 
0.050 + 0.020 


0.018 +0 003} le 
0.010 NOM PIN SPACING 0.100 T.P. 


(See Note A) 


at UL 


0.050 + 0.010 


NOTES: A. The true-position pin spacing is 0.100 between centerlines. Each pin centerline is located within 0.010 
of its true longitudinal position relative to pins 1 and 40. 
B. All dimensions are in inches untess otherwise noted. 
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APPENDIX E 


APPENDIX E 


a 


| @ 
How to Align the Intecolor 8001. 


CONTENTS 


1.0 SAFETY PRECAUTIONS 
1.0.1 HIGH VOLTAGE 


1.0.2 X-RADIATION PRECAUTIONS 


2.0 INSTALLATION AND SERVICE ADJUSTMENTS 


SERVICING PRECAUTIONS 

AC LINE TAP SELECTOR 

VERTICAL DEFLECTION 

HORIZONTAL DEFLECTION 

HIGH WOLTAGE ADJUSTMENT 

FOCUS ADJUSTMENT 

PURITY ADJUSTMENT 

COLOR TEMPERATURE ADJUSTMENTS 

TOP, BOTTOM, AND SIDE PINCUSHION ADJUSTMENT 
.L0 CONVERGENCE ADJUSTMENT PRELIMINARIES 
.L1 CONVERGENCE STATIC ADJUSTMENTS 

.l12 FINAL CONVERGENCE 
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1.0 SAFETY PRECAUTIONS 


WARNING: The following precautions should be observed: 


1. 


Do not install, remove, or handle the picture tube in any 
manner unless shatter-proof goggles are worn. People not 
so equipped should be kept away while picture tubes are 
handled. Keep picture tube away from the body while 
handling. 


Part of the High Voltage is connected to the AC line 
directly. This circuitry, found on the Analog Module 
(100047), is isolated from the remainder of the circuitry 
by optical isolator, U3, and driver transformer, T101. 
Should service of the High Voltage be required it is 
recommended that an isolation transformer be inserted in 
the power line between the Intecolor8001 and the AC 
supply before any service is performed. When the Chassis 
must be operated directly from the AC supply, the power 
plug should always be inserted in the correct polarity to 
connect the High Voltage common (emitter of Q5) to the 
ground side of the AC line. Check with a VOM or oscillo- 


scope to see if a potential exists between this point and 


a known earth ground. A zero reading should be obtained. 
If any voltage reading is obtained, reverse the power plug 
and recheck for zero meter reading. | 


When service is required, observe the original lead dress. 
Extra precaution should be given to assure correct lead dress 
in the high voltage circuitry and video area. Where a short 
circuit has occurred, replace those components that indicate 
evidence of overheating. Always use the manufacturer's 
recommended replacement component. 


1.0.1 


L022 


HIGH VOLTAGE 


NOTE: THE NOMINAL HIGH VOLTAGE FOR THE INTECOLOR® 8001 
17"" or 19" TERMINAL IS 25 KV. THE HIGH VOLTAGE MUST 
NOT, UNDER ANY CIRCUMSTANCES, EXCEED 27.5KV. 


Each time a terminal's High Voltage requires servicing, 
measurements should be made at normal viewing settings 
of the Brightness Control. This will afford assurance 
that; 


Ll. The High Voltage is within limits specified. 

2. The High Voltage regulation circuit is function- 
ing properly. 

3. X-Radiation is at a minimun. 


If the High Voltage measures abnormally high or the 

High Voltage Regulation Circuit is not functioning properly, 
the Terminal should be restored to normal operation through 
service or adjustments. (See 2.0.5 for High Voltage 
Adjustment procedure.) 


IT IS IMPORTANT TO USE AN ACCURATE AND RELIABLE HIGH 
VOLTAGE METER. 
X-RADTATION PRECAUTIONS 


The primary source of X Radiation in this Terminal is 
the picture tube. 


The tube utilized for the above mentioned function in 
the terminal is specifically constructed to limit X- 


Radiation emissions. 


For continued X-Radiation protection, the replacement tube 
must be the same type as the original, including suffix 
letter, or an ISC approved type. 


INSTALLATION AND SERVICE ADJUSTMENTS 
SERVICING PRECAUTIONS - 


Purity, Color, Temperature, and Convergence adjustments 
for the Intecolor®8001 are essentially the same as for 
conventional shadow mask color tubes. Certain pre- 
cautions should be taken, however, in servicing the 
Intecolor®8001 terminal. | 


Some precautions to observe while servicing the solid 
state chassis are listed below: 


1. Always connect the ground lead of a test instrument 
to the chassis before connecting the positive lead; 
conversely, always remove the ground lead of a test 
instrument last. 


2. Do not check for high voltage by drawing an arc. Use 
a high voltage meter or a high voltage probe with a VOM. 


3. Do not bridge electrolytic capacitors since resultant 
| surges may damage solid state devices. 


4. Some transistors are equipped with heat sinks. Do not 
operate the transistor with the heat sink removed. 


5. All soldering irons used where transistors and integrated 
chips are concerned should be 35 watt (6 volts) irons and 
grounded in such a way that no voltage will be applied to 
the solid state device during the soldering operation. 
This precaution is to prevent possible damage to the 
device due to excessive heat or voltage applied under 
no bias conditions. 


6. When servicing the video circuitry it is recommended that 
an oscilloscope of at least 100 MHZ bandwidth, such as 
the Tektronix 454A, be used. 


ZeVicl 


2.0.4 


AC LINE TAP SELECTOR 


The AC Line Tap Selector is located inside the chassis 
on the right hand side as viewed from the rear (See 
Figure 2.0.2.1). In areas having a LLI5VAC line 
supply, this tap should be left in the 115 VAC 
position. Other taps are shown depending on the 

line voltage. 


VERTICAL DEFLECTION 


At 115 volts line voltage adjust the VERTICAL HEIGHT 
CONTROL, R3, (See Figure 2.0.3.1) and the VERTICAL 
POSITION CONTROL, R4, so that the picutre is centered 
and there is a 12' wide by 10" high display. A 
suitable display is found by filling up the screen 
with a single character or erasing the screen with 

a background color. 


HORIZONTAL DEFLECTION 


Adjust the HORIZONTAL WIDTH CONTROL, R6, (Analog 
Module, 100047) (See Figure 2.0.3.1) so that the 
picture has a 12" wide by 10" high display. 
HORIZONTAL CENTERING is accomplished by adjusting 
R3 on the rear edge of the Display Generator Card, 
100117. Adjusting the Pot R3 causes one character 
movements, to the right or left of the screen. 


Blue/Wht 105 
Black/Wht 115 

Green/Wht 125 Black 
Red/Wht 135 Tap Selector 


AC LINE TRANSFORMER TAP SELECTION 
FICURE 2.0.2.1 


Horizontal Horizontal 
Pincushion 4& (4) Width 
R/ R6 


Vertical 
Height 
@ 


Vertical Vertical 
Position (4) 4) Pincushion 
R4 R5 


ANALOG MODULE (100047) PRINTED CIRCUIT BOARD BOTTOM VIEW 
FIGURE 2.0.3.1 


Z 


2 


0:2 


.0.6 


2.0. 
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HIGH VOLTAGE ADJUSTMENT 


Preset High Voltage Adjustment Control R8 (Analog 
Module 100047) to 1/2 clockwise, and Brightness 
Control R17, to maximum counterclockwise (minimum 
brightness). 


Remove the High Voltage Anode Cap from the tube and 
connect a Pomona #2900A or equivalent to the High 
Voltage Cap. CAUTION: BE SURE HV PROBE GROUND IS 
GROUNDED. INSURE THAT ANODE CAP IS ISOLATED FROM 
ALL PERSONS AND EQUIPMENT. Adjust High Voltage 
Control, R8 for 25 KV. 


FOCUS ADJUSTMENT 


Create a full page of white dots on the CRT screen 
by utilizing the following procedure; 


1. Select Foreground Color - WHITE 
2. Select Background Color - BLACK 


3. Press keyboard "." (period) and allow to 
repeat until screen is full of white dots. 


Adjust the FOCUS pot (found on the right side (viewing 
from rear) of the Analog Card mounting bracket. 

Remove the external case with 6 screws) for optimum 
focus over the entire screen. (See Figure 2.0.6.1) 


PURITY ADJUSTMENT 


The Intecolor®8001 should always be facing either north 

or south during purity adjustment. This assures that any 
effect of the earth's normal magnetic field upon beam landing 
will be negligible when the terminal is placed in its 

normal viewing location. © 


The instrument should be at room temperature (60°F or above) 
for at least 30 minutes before set-up adjustments are made. 
Allow a minimum of ten minutes operation at high beam current 
(brightness full without bloom) before attempting purity 

or convergence adjustments. 


R18 Focus Adjustment 


Rl7 Brightness 
Adjustment 


Remove 3 Screws 
on each side to 
remove case. 


FOCUS AND BRIGHTNESS ADJUSTMENT LOCATION 


FIGURE 2.0.6.1 


Should any parts of the chassis become magnetized, it 
will be necessary to manually degauss the affected areas. 
Move a manual (GC 9317 or equivalent) degaussing coil 
slowly around those areas and the face of the CR Tube 
and slowly withdraw to a distance of six feet before 
disconnecting the coil from the AC power source. 


Before performing the purity adjustments, the center of 
the raster must be converged and the dynamic convergence 
set roughly as explained in Section 2.0.12. Check 
that the focus control is properly set (See Section 2.0.6). 
The focus adjustment should be made with the brightness 
control set at maximum beam current without bloom. 


l. Purity adjustments are most accurate while 
observing one screen only, preferably red. 
Erase the screen with the background color "RED". 


2. Loosen the yoke wing nuts and move the yoke to the 
rear as far as possible. (See Figure 2.0.7.1) 


3. Rotate the purity magnets and adjustment tabs so 
that a clean red area is produced at the center 
of the screen. Push the yoke forward until a 
uniform red raster is obtained. Tighten the 
yoke wing nuts. 


4. Erase the screen with the background color 
"WHITE". Check for a uniform white screen 
(see COLOR TEMPERATURE ADJUSTMENTS, Section 2.0.8, 
for procedure). If uniformity has not been 
obtained, reconverge the center of the screen 
and repeat the purity adjustments. 


5. It should be noted that purity adjustments also 
affect the focus and DC Horizontal and Vertical 
screen positions and these parameters may have to 
be readjusted as outlined under Sections 2.0.3, 
2.0.4, and 2.0.6. 
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COLOR TEMPERATURE ADJUSTMENTS 


1. Place a screen full of WHITE characters or ERASE 
the screen in WHITE. Turn the screen grid drive 
controls R14 (RED), R15 (GREEN), R16 (BLUE) (Analog 
Module 100047) to minimum drive (Fully CCW) then 
turn the BRIGHTNESS Control, R17 to maximum brightness 
(Fully CW). 


2. Turn the RED control, R14, clockwise until the red 
vertical retrace raster line at the top of the screen 
is just visible. Turn the GREEN Control, R15, clock- 
Wise until the green vertical retrace raster line at 
the top of the screen is just visible. Repeat the 
same for the BLUE Control, R16. 


3. Adjust the BRIGHTNESS Control, R17, until there is 
no visible vertical retrace raster line and the 
brightness is at a comfortable viewing level with a 
minimum of color saturation. 


4, Adjust each screen grid drive control, RED (R14), 
GREEN (R15), and BLUE (R16), until a white screen 
is obtained, or a 9300°K color temperature (WHITE). 


TOP, BOTTOM, AND SIDE PINCUSHION ADJUSTMENT 


Place a suitable test pattern on the screen such as all 
'4' (plus) symbols or all "."' (periods). (See Seetion 
2.0.6 for pattern set-up). Any color or WHITE may be used. 


The top and bottom (Vertical) pin cushion adjustment is 
made, if necessary, by adjusting R5 on the Analog Module 
(100047) for straight horizontal lines at the top and 
bottom of the raster as shown in Figure 2.0.3.1 and 
Figure 2.0.9.1. 


The side (Horizontal) pin cushion adjustment is made by 


adjusting R7 on the Analog Module (100047) for straight 
vertical lines on the left and right side of the raster. 
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CONVERGENCE ADJUSTMENT PRELIMINARIES 


The CONVERGENCE ADJUSTMENT PRELIMINARIES are necessary 
only if convergence cannot be obtained as outlined under 
FINAL CONVERGENCE ADJUSTMENTS (Section 2.0.12), or if 
these areas have required service or parts replacements, 
or the adjustment pots have been tampered with. An 
oscilloscope, such as the Tektronix 454, or equivalent 
will be necessary for these adjustments. 


PRELIMINARY HORIZONTAL RAMP ADJUSTMENT 


The Horizontal Ramp U11/6 amplitude is adjusted by Rl on 
the Analog Module (100047). The ramp is adjusted so 

that the positive peak is equal in height to the negative 
peak (symmetrical about ground or W =V-). (See 

Figure 2.0.10.1.1). 


PRELIMINARY VERTICAL RAMP ADJUSTMENT 


The VERTICAL RAMP U10/6 amplitude is adjusted by R2 on 
the Analog Module (100047) in the same manner as the 
HORIZONTAL RAMP ADJUSTMENT (See Figure 2.0.10.1.1). 


PRELIMINARY HORIZONTAL PARABOLA ADJUSTMENT (U7/3) 
RIGHT & LEFT CENTER, TUBE AREAS 4 & 5 (See Figure 2.0.12.2). 


Adjust R9 on the Analog Module (100047) until the bottom 
of the Parabola is at Ground level. See Figure 2.0.10.3.1. 


PRELIMINARY VERTICAL PARABOLA ADJUSTMENT (U8/3) 
TOP & BOTTOM CENTER, TUBE AREAS 2 & 3 (See Figure 2.0.12.2). 


Adjust RLO on the Analog Module (100047) until the bottom 
of the Parabola is at ground level. See Figure 2.0.10.3.1. 


HORIZONTAL AND VERTICAL RAMP ADJUSTMENTS. 


Monitor the HORIZONTAL PARABOLA at U7/3 on the Analog 
Module (100047). Superimpose a small amount of the video 
Signals (with a screen full of WHITE characters) by 
adding a small amount of the "B" trace (connect a scope 
probe to the collector of Q26 or Q27 or Q28) on the 
oscilloscope (CHOP, INVERT B, ADD) to the"'A" trace 


(connected to U7/3). The above may also be accomplished 
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2.0.10.6 
2.0.10.7 


2.0.10.8 


by simply connecting the "'A"’ channel Scope ground to a 
ground in the vicinity of Q26, Q27, or Q28. The video 
will be apparent on the parabola, as shown in Figure 
20.20 6041. 


Adjust Rl until the superimposed video is as shown 
in Figure 2.0.10.5.1. 


Monitor the VERTICAL PARABOLA at U8/3 and adjust R2 of 
the Analog Module (100047) until the end points of the 
parabola are equal in height. 


The above procedure is shown in Figure 2.0.10.5.2. 
VACANT 


CORNER PARABOLA ADJUSTMENTS 
TUBE AREAS 6, 7, 8, and 9 (See Figure 2.0.12.2) 


The CORNER PARABOLA ADJUSTMENTS are made by R11, R12 

and R13 on the Analog Module 100047 and monitoring the 
waveform as shown at U14/3 as in Figure 2.0.10.7.1. 

OFFSET is adjusted to zero by R13 by adjusting the 
waveform baseline to ground as shown in Figure 2.0.10.7.1, 
Waveform A. 


BASELINE SLANT is adjusted by R12 on Analog Module 
(100047) as shown in B of Figure 2.0.10.7.1. Adjust 
for Voc equal to "0" volts. 


VERTICAL SYMMETRY is adjusted as shown in C of 
Figure 2.0.10.7.1 using R11 on Analog Module (100047). 
Alignment is made by adjusting R11 until +Vic = “Vic: 


HORIZONTAL, VERTICAL and CORNER PARABOLA TOUCH-UP 


Touch up of the HORIZONTAL, VERTICAL, and CORNER PARABOLAS 
can best be accomplished by monitoring the waveforms on 
the Jl on the Convergence Module (100014). 


A. Adjust the HORIZONTAL PARABOLA offset, Vyp with R9 
on the Analog Module (100047) by monitoring the 
waveform at J1l/1 on the Convergence Module (100014) 
as shown in Figure 2.0.10.8.1, A. 


B. Adjust the VERTICAL PARABOLA offset, V,,,. with R10 on 
the Analog Module (100047) by monitoring the waveform 
at J1/5 on the Convergence Module (100014) as shown in 
Figure 2.0.10.8.1, B 


C. Adjust the CORNER PARABOLA offset, Vep with R13 on 
the Analog Module (100047) by monitoring the waveform 
at J1/7 on the Convergence Module (100014) as shown 
in Figure 2.0.10.8.1, C. 
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FIGURE 2.0.10.5.2 
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2. Monitor waveform at U14/3 
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C., CORNER PARABOLA VERTICAL SYMMETRY 


1. Adjust R11 Analog Module 
(100047) to +Vyc = -Vuc 


2. Monitor waveform at U14/3 
on Analog Module (100047) 


CORNER PARABOLA ADJUSTMENTS 
FIGURE 2.0.10.7.1 
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220% 11 CONVERGENCE STATIC ADJUSTMENTS 


Place a dot pattern on the screen in the following 
manner from the Keyboard. 


Define FOREGROUND COLOR AS "WHITE" 
BACKGROUND COLOR AS "BLACK" 


Depress ".'' (period) Key and allow to repeat 
until the screen is full of white dots. 


The above will fill up the screen with dots. Now 
place '+" symbols utilizing the keyboard as shown 
in Figure 2.0.11.1 | 


Turn all the pots on the Convergence Module (100014) to 
the straight up position as shown in Figure 2.0.11.3. 


Now adjust the static magnets and the Blue Lateral Magnet 
to align the "+" symbols R,G,B, colors in Screen Sector 1, 
as shown in Figure 2.0.11.2, so as to appear as "WHITE". 
This will occur when the RED, GREEN, AND BLUE colors are 
accurately superimposed on top of each other. With the 
exception of BLUE lateral which is explained below. 


For the above to be accurate the tube must have been 
externally degaused, the Purity adjusted, the FOCUS R18 
adjusted for sharp, and the BRIGHTNESS, R17, Analog 
Module (100047), set for a low level with the color 
temperature being set to 9600°K as explained in previous 
sections. DO NOT ATTEMPT FURTHER CONVERGENCE UNLESS THE 
ABOVE HAS BEEN PREVIOUSLY PERFORMED, (See Sections 


The beams move at approximately the same angle as the 
convergence magnets are offset from the vertical plane. 
Blue, since it is mounted in the vertical plane moves 
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CONVERGENCE TEST PATTERN 


FIGURE 2.0.11.1 


the beam up and down vertically; red and green move the 
respective beams on a line at about a 60° angle from the 
vertical. The blue lateral magnet moves all three beams 
in the horizontal plane, the blue beam in one direction 
and the red and green beams in the opposite direction in 
a5 to 1 ratio. The blue beam has the greatest lateral 
shift. 


The thumb screw adjustment of red, green, and blue center 
convergence magnets can be rotated in either direction 
continuously. Flux change is accomplished by rotating 
the pole position of the magnets, not by moving the 
magnets farther from or closer to the respective guns. 


Adjust the Static Blue so that the Blue in the center of 
the screen is superimposed on the RED and GREEN. 


Ze Owe FINAL CONVERGENCE 


Touch up the center convergence with the pots R13 (GREEN), 
R14 (RED) and R15 (BLUE) on the Convergence Module (100014) 
as shown in Figure 2.0.11.2 and Figure 2.0.11.3. 


Once center convergence has been adjusted proceed to the 

next convergence Screen Sector, 2, as shown in Figure 2.0.11.2. 
Proceed with the alignment in the order of the sector numbers 
as shown in Figure 2.0.11.2. After each Sector is aligned, 
check and touch up the center convergence. Note that 

the adjustment pots on the Convergence Module (100014) are 
arranged in the same location as each Screen Sector as 

viewed on the tube face (and the component side of the 

board) and the trio of pot groups in each sector are 

arranged as GREEN, RED, AND BLUE corresponding to the 
location of the GREEN, RED, and BLUE electron beams as 

viewed from the tube face. 


When completed with the above, touch up each Screen Sector 
as needed in the SAME ORDER as outlined above. Do not 
violate the order of the Screen Sector numbers in the 
adjustment procedure. 


Never attempt a convergence procedure without first setting 
the Convergence Module (100014) pots to the center position 
as shown in Figure 2.0.12.3 and following the Screen Sector 
numbers. It is seldom necessary for the static magnets to 
be adjusted unless shipment vibration causes convergence 
coil or static magnet movements or unless convergence coil 
or yoke replacements become necessary. 
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CR TUBE CONVERGENCE SECTORS (SCREEN VIEW) 
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CONVERGENCE BOARD ASSEMBLY SHOWING 
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BASIC 8001 


INTRODUCTION 


BASIC 8001 is a single-user, conversational programming language which 
uses Simple English-type statements and familiar mathematical notations 
to perform an operation. BASIC 8001 is one of the simplest computer 
languages to learn and once learned has the facility of advanced tech- 
niques to perform more intricate manipulations or express a problem 
more efficiently. 


BASIC 8001 is in incremental compiler which provides immediate translation 
and storage of user programs being input. This method decreases the 
response time of a RUN command and increases execution speed. BASIC 8001 
has provision for alphanumeric character string, I/O and string variables, 
and allows user defined functions and assembly language subroutine calls 
from user BASIC 8001 programs. 


BASIC 8001 can be run on any Intecolor 8001, Intecolor 8051 or Compucolor 
8001 with a minimum of 8K of user workspace. 


LOADING AND RUNNING BASIC 8001 
BASIC 8001 is provided in ROM and runs in ROM. BASIC 8001 is initiated by 
typing the ESC key, then the W (BASIC) key. The dialoque described below 
1s printed. This is a once-only dialogue and does not occur after an ESC 
key, and E key sequence. The READY message is printed after the ESC, E key 
sequence. 
BASIC 8001 prints: 

BASIC 8001 V12/8/76 COPYRIGHT (C) 1976 BY CHARLES MUENCH 


MAXIMUM RAM ADDRESS? 


The user then types the highest RAM address that he has available or wants 
to use and then keys a carriage return. 


One extra RAM card is 49151 
Two extra RAM cards is 57343 
Three extra RAM cards is 65529 
BASIC 8001 then prints the message, 
READY 
and waits for a command or program line to be typed. 
If BASIC 8001 has been initialized as above but has returned to the CRT 
O.S. (by CPU Reset Key), then BASIC 8001 can be recalled without disturbing 


existing programs by typing the ESC key, then the E key. BASIC 8001 will 
then print the message READY. | 


If power fails, the CPU Reset key is hit or the unit is turned off, 
the unit returns to the CRT operating mode. 


If the CPU Reset key or ESC delete keys are hit, the unit leaves 
BASIC 8001 and returns to the CRT operating mode. Any BASIC 8001 
statement program is saved and can later be recalled if BASIC 8001 
is re-entered by typing ESC, E. 


BASIC 8001 has twenty-four (24) key word program statements, thirteen 
(13) editing and command statements, eighteen (18) mathematical functions, 
nine (9) string functions and eighteen (18) two-letter error messages. 
With these command and statement capabilities, BASIC 8001 is extremely 
simple to use and yet very versatile and powerful. 


The next section provides an easy reference to BASIC 8001 capabilities. 
If the user is unfamiliar with BASIC 8001 language, then the remaining 
portion of this manual should be studied in sequence while having a 
terminal at your fingertips to run the example given. This manual 
should enable the user to become very proficient in BASIC 8001 when 
finished. Intelligent Systems Corporation and Compucolor Corporation 
have a number of BASIC 8001 programs on Floppy Tapes and are available 
at nominal prices. In addition, both companies will pay for BASIC 8001 
programs that are provided on floppy tape when properly documented and 
accepted. Enjoy your self programming in BASIC 8001! 


BASIC 8001 


SUMMARY OF COMMANDS 


1. BASIC 8001 STATEMENTS 


The following summary of BASIC statements defines the general format for 
the statement and gives a brief explanation of its use. 


DATA value list 

DEF function (argument) = 
expression 

DIM variable (n), variable (n,m), 
variable $(n), variable $(n,m) 

END 

FOR variable=expressionl TO 

expression2 STEP expression3 

GOSUB line number 


GOTO line number 


THEN 
IF expression GOTO line number 


INPUT list 


INPUT "string"; list 


LET variable = expression 
NEXT variable 
ON X GOSUB line number list 


ON X GOTO line number list 


Used in conjunction with READ to input 
data into an executing program. 


Defines a user function to be used in 
the program. 


Reserves space for lists and tables 
according to subscripts specified after 
variable name. 


Placed at the physical end of the 
program to terminate program execution. 


Sets up a loop to be executed the 
specified number of times. 


Used to transfer control to the first 
line of a subroutine. 


Used to unconditionally transfer control 
to other than the next sequential line 
in the program. 


Used to conditionally transfer control 
to the specified line of the program. 


Used to input data from the terminal 
keyboard, promps with "?". 


Used to input data without promp character. 


Used to assign a value to the specified 
variable(s). 


Placed at the end of a FOR loop to 
return control to the FOR statement. 


Call the Xth line number subroutine 
after GOSUB. 


Branch to the Xth line number after GOTO. 


OUT I,X 


PLOT expression 


qn 6 
oe 
Laos 
POKE I vr x af oo ok 
‘ “as 
= 
PRINT list 


PRINT expression 


PRINT "string" 


4 


PRINT TAB (x) 


READ variable list 


REM comment 


RESTORE 


RETURN 


STOP 


WAIT X,I,J 


—— 
; #£ 


Causes the X BYTE to be output to port I. 


Sends the one BYTE result of the expression 
to the 8001 CRT. The result must be 


‘e between O and 255 binary. 


Causes the X BYTE to be placed in memory 


“|G 4 location 0 <I 32767. If I is negative 
“ then address is 65536,- I. 


wh 


pit fatty 
samme AR io 


Used to output a 6 the ee 
Prints results of expression. 

Prints a character string. 
Equivalent to the word PRINT. 


Used to space to the specified column. 


Used to assign the values listed ina 
DATA statement to the specified 
variables. 


Used to insert explanatory comments into 
a BASIC 8001 program. 


Used to reset data block pointer so the 
same data can be used again. 


Used to return program control to the 
statement following the last executed 
GOSUB statement. 


Used at the logical end of the program 
to terminate execution. 


Causes the input port X to be read, 
exclusive OR'ed with BYTE J, and then 
AND'ed with BYTE I. The program will 
wait until the result is zero before 
continuing. 


2. COMMANDS 


The following key commands halt program execution, erase characters or delete 


lines. 


Key 


CTRL/J or Line Feed 


CTRL/M or RETURN 


CTRL/K or ERASE LINE 


CTRL/L or ERASE PAGE 


CTRL/Z or CURSOR LEFT 


Explanation 


Terminates program execution. BASIC 8001 


prints READY. 


Must be typed to end every line typed 
in or to indicate the end of an INPUT. 


A colon is used to separate multiple 
statements per line. 


Deletes the entire current line. 
Erases the CRT screen, but does not 
change or disturb BASIC 8001 statements 


in any way. 


Deletes the last character entered and 
echoes a cursor left. 


The following commands list, load, save, erase and execute the program currently 


in core. 
Command 


CLEAR 

CLEAR X 

LIST 

LIST line number 
LOAD I 

LOAD ? I 

RUN 

RUN line number 


SAVE I 


Explanation 


Sets the array and string buffers to 
nulls and zeroes. 


Sets space for string variable to X 
characters normally 50 characters. 


Prints the user program currently in 
core on the list output device. 


Prints the program from the line speci- 
fied to the end. 


Does a NEW and inputs the program on track 


#I from the READER input device. 


Does not do a NEW but inputs and compares 


the program on track #I with what is 
existing in RAM Memory. 


Executes the program in the buffer area. 


Executes the program starting at line 
number specified. 


Outputs the program in core to track #I 
of the WRITE output device. 


NEW Erases the entire storage area. 


CONT | Continues execution after CTRL/J is 
typed or after a STOP statement. 


The following functions perform standard mathematical operations in BASIC 8001. 


Name 


ABS (x) 


ATN (x) 


CALL (x) 


COS (x) 
EXP (x) 
FRE (x) 


INT (x) 


INP (x) 


LOG (x) 


PEEK (x) 


POS (x) 


RND (x) 
SGN (x) 
SIN (x) 
SPC (x) 
SOR (x) 


TAB (x) 


TAN (x) 


Explanation 


Returns the absolute value of x. 


Returns the arctangent of x as an angle 
in radians in the range + or - pi/2. 


Call the user machine language routine 
at location OAOOO HEX. 


Returns the cosine of x radians. 
Returns the value of e* where e=2.71828. 
Returns number of free BYTES not in use. 


Returns the greatest integer less than 
or equal to x. 


Returns a BYTE from input port 0<x € 255. 
Returns the natural logarithm of x. 

Returns a BYTE from memory address 0<x<32767 
or if X is negative the memory address 


is 65536- x. 


Returns a value O to 79 current cursor 
position. 


Returns a random number between O and l. 
Returns a value indicating the sign of x. 
Returns the sine of x radians. 

Causes x spaces to be generated. 

Returns the square root of x. 


Causes the cursor to tab to column 
number x when used in a print statement. 


Returns the tangent of x radians. 


The string functions are: 
Name 
ASC (x$) 


CHRS (x) 


FRE (x$) 


LEFTS (x$,I) 

LEN (x$) 

MIDS (x$,I,J) 
RIGHTS (x$,TI) 
STRS (x) 


VAL (x$) 


Explanation 
Returns as a decimal number the seven-bit 
internal code for the first character of 


string (x$). 


Generates a one-character string having the 
ASCII value of x. 


Returns number of free string BYTES. 


Returns left most I characters of string 


(x$). 


Returns the number of characters in the 
string (xS$). 


Returns J characters of string (x$) 
starting at position I. 


Returns right most I characters of string 


(xS). 


Returns the string which represents the 
numeric value of x. 


Returns the number represented by the string 
(x$). 


LIST OF VARIABLES USED FOR THIS TEST 


XS='ABCDE' 


X=123 
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A=ASC(XS$) 
AS=CHRS (X) 
A=FRE(X$) 
A=LEFTS (X$,2) 
A=LEN (XS) 
AS=MIDS(X$,2,2) 
AS=RIGHTS (XS,3) 
AS=STRS (X) 
A=VAL(XS$) 


ERROR MESSAGES 


After an error occurs, BASIC 8001 returns to command level and types 
READY. Variable values and the program text remain intact, but the program 
cannot be continued and all GOSUB and FOR context is lost. 


When an error occurs in a direct statement, no line number is printed. 
Format of error messages: 

Direct Statement XX ERROR 

Indirect Statement XX ERROR IN YYYYY 


In both of the above examples, "XX" will be the error code. The "YYYYY" 
will be the line number where the error occurred for the indirect statement. 


The following are the possible error codes and their meanings: 
ERROR CODE MEANING 


BS Bad Subscript. An attempt was made to reference a 
matrix element which is outside the dimension of the 
matrix. This error can occur if the wrong number of 
dimensions are used in a matrix reference; for instance, 
LET A (1,1,1)=Z when A has been dimensioned DIM A(2,2). 


DD Double Dimension. After a matrix was dimensioned, 
another dimension statement for the same matrix was 
encountered. This error often occurs if a matrix has 
been given the default dimension 10 because a statement 
like A(1)=3 is encountered and then later in the program 
a DIM A(100) is found. 


CF Call Function error. The parameter passed to a math. 
or string function was out of range. 
CF errors can occur due to: 
a) a negative matrix subscript (LET A(-1)=0) 
b) an unreasonably large matrix subscript (732767) 
c) LOG-negative or zero argument 
ad) SQR-negative argument 


e) A B with A negative and B not an integer. 


f) A CALL (X) before the address of the machine 
language subroutine has been patched in 


g) calls to MIDS, LEFTS, RIGHTS, INP, OUT, WAIT, 
PEEK, POKE, TAB, SPC or ON...GOTO with an improper 
argument. 


ID 
NF 


OD 


OM 


OV 


SN 
RG 


US 


/O0 


CN 


LS 


OS 


oT 


TM 


Tllegal Direct. You cannot use an INPUT or DEF 
statement as a direct command. 


NEXT without FOR. The variable in a NEXT statement 
corresponds to no previously executed FOR statement. 


Out of Data. A READ statement was executed but all 
of the DATA statements in the program have already 
been read. The program tried to read too much data 
or insufficient data was included in the program. 


Out of Memory. Program too large, too many variables, 
too many FOR loops, too many GOSUB's, too complicated 
an expression or any combination of the above. 


Overflow. The result of a calculation was too large 
to be represented in BASIC's number format. If an 
underflow occurs, zero is given as the result and 
execution continues without any error message being 
printed. 


Syntax error. Missing parenthesis in an expression, 
illegal character in a line, incorrect punctuation, etc. 


RETURN without GOSUB. A RETURN statement was encountered 
without a previous GOSUB statement being executed. 


Undefined Statement. An attempt was made to GOTO, GOSUB 
or THEN to a statement which does not exist. 


Division by Zero. 


Continue error. Attempt to continue a program when 
none exists, an error occurred, or after a new line was 
typed into the program. 


Long String. Attempt was made by use of the concatenation 
operator to create a string more than 255 characters long. 


Out of String Space. Save your program on paper tape 
or cassette, reload BASIC and allocate more string 
space or use smaller strings or less string variables. 


String Temporaries. A string expression was too complex. 
Break it into two or more shorter ones. 


Type Mismatch. The left hand side of an assignment 
statement was a numeric variable and the right hand 
Side was a string, or vice versa; or, a function 
which expected a string argument was given a numeric 
one or vice versa. 
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UF 


Undefined Function. Reference was made to a user 
defined function which had never been defined. 
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BASIC 8001 ARITHMETIC 


a NUMBERS 


BASIC treats all numbers (real and integer) as decimal numbers--- 
that is, it accepts any decimal number and assumes a decimal point 
after an integer. The advantage of treating all numbers as decimal 
numbers is that any number or symbol can be used in any mathematical 
expression without regard to its type. Numbers used must be in the 
approximate range 10-38ene10t38 , 


In addition to integer and real formats, a third format is recognized 
and accepted by BASIC 8001. This format is called exponential or 
E-type notation, and in this format, a number is expressed as a 
decimal number times some power of 10. The form is: 


xxXEn 


where E represents "times 10 to the power of"; thus the number is 
read "xx times 10 to the power of n". For example: 


23.4E2=23.4*102 = 2340 


Data may be input in any one or all three of these forms. Results 
of computations are output as decimals if they are within the range 
«Ol n. 999999; otherwise, they are output in E format. Numbers are 
stored up to 24 bits of significance. If a number with more than 
24 bits is entered, it is truncated and stored as 24 bits. BASIC 
8001 handles six significant digits in normal operation and prints 
6 decimal digits as illustrated below: 


Value Typed In Value Output by BASIC 8001 
.O1 OL 
.0099 | 9.9O0000E-03 
999999 999999 
1000000 1. OOOO0E+06 


BASIC automatically suppresses the printing of leading and trailing 
zeroes in integer and decimal numbers, and, as can be seen from the 
preceding examples, formats all exponential numbers in the form: 


(sign) x.xxxxxE(+ or -)n 
where x represents the number carried to six decimal places, E stands 
for "times 10 to the power of", and n represents the exponential value. 


For example: 


-3.47021E+08 is equal to -347,021,000 
7.26000E-04 is equal to .00726 


Floating point format is used when storing and calculating most numbers. 
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NOTE 


Because core size limitations prohibit the storage of 
infinite binary numbers, some numbers cannot be expressed 
exactly. In BASIC 8001, accuracy is approximately 5- 
digits, and errors in the 6th digit can occur. For 
example, .999998 as a result of some functions may be 
equal to 1. Discrepancies of this type are magnified when 
such a number is used in mathematical operation. 


LE. VARIABLES 


A variable in BASIC 8001 is an algebraic symbol representing a number, and 
is formed by a single letter, a letter optionally followed by a single 
digit or by double letters. For example: 


Acceptable Variables Unacceptable Variables 
I 2C-a digit cannot begin a variable. 
B3 li-numbers alone cannot form a 
variable. 
AB 
X 


Subscripted and string variables are described in later sections. The 
user may asSign values to variables either by indicating the values in 
a LET statement, or by inputting the values as data; these operations 
are discussed in another chapter. 


The value assigned to a variable does not change until the next time a 
statement is encountered that contains a new value for that variable. 
All variables are set equal to zero (0) when the RUN command is issued. 
It is only necessary to assign a value to a variable when an initial 
value other than zero is required. However, good programming practice 
would be to set variables equal to O wherever necessary. This ensures 
that later changes or additions will not misinterpret values. 


Tit. SUBSCRIPTED VARIABLES 


In addition to the simple variables described in the preceding section, 
BASIC 8001 allows the use of subscripted variables. Subscripted variables 
provide additional computing capabilities for dealing with lists, tables, 
matrices, or any set of related variables. In BASIC 8001 variables are 
allowed from 1 to 31 subscripts. 


The name of a subscripted variable is any acceptable BASIC 8001 variable 
name followed by one or more integer expressions in parentheses within 


the range 0-32767. For example, a list might be described as A(I) where 
I goes from O to 5 as shown below: 


A(0) ,A(1) ,A(2) ,A(3) ,A(4) ,A(5) 
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This allows reference to each of the six elements in the list, and can 
be considered a one dimensional algebraic matrix as follows: 


A two-dimensional matrix B (I,J) can be defined in a similar manner: 
B(0,0),B(0,1),B(0,2),. . .,B(OJ),. . .,B(I,dJ) 


and graphically illustrated as follows: 


B(0,1) B(0,2) 


B(I,0) B(I,1) B(I,2) B(I,3) 


Subscripts used with subscripted variables throughout a program can be 
explicitly stated or be any legal expression. If the value of the expression 
is non-integer, the value is truncated so that the subscript is an integer. 


It is possible to use the same variable name as both a subscripted and 
unsubscripted variable. Both A and A(I) are valid variables and can be 
used in the same program. The variable A has no relationship to any 
element of the matrix A(I). BASIC 8001 will accept the same variable 
name as both a singly and a doubly subscripted variable name in the same 
program. 


Character strings may also be subscripted variable arrays, and may have 
the same variable name i.e., AS(I). 


A Dimension (DIM) statement is used with subscripted variables to define 
the maximum number of elements in a matrix. ("Matrix" is the subscripted 
variable.) The DIM statement is discussed in a later paragraph. 


If a subscripted variable is used without appearing in a DIM statement, 
it is assumed to be dimensioned to length 10 in each dimension (that 
is, having eleven elements in each dimension, 0 through 10). However, 
all matrices should be correctly dimensioned in a program. 


IV. EXPRESSIONS 


An expression is a group Of symbols which can be evaluated by BASIC 8001. 
Expressions are composed of numbers, variables, functions, or a 
combination of the preceding separated by arithmetic or relational 
operators. 


The following are examples of expressions acceptable to BASIC 8001: 


Arithmetic Expressions String Expressions 
4 AS+BS+"ABC" 


A7* (BA2+1) 


Not all kinds of expressions can be used in all statements, as is 
explained in the sections describing the individual statements. 


V. ARITHMETIC OPERATIONS 


BASIC 8001 performs addition, subtraction, multiplication, division and 
exponentiation. Formulas to be evaluated are represented in a format 
Similar to standard mathematical notation. The five operators used in 


writing most formulas are: 


Symbol 
Operator Example Meaning 

OR Logical and bitwise "OR" 
AND Logical and bitwise "AND" 
NOT Logical and bitwise "NOT" 
+ A+B Add B to A 

- A-B Subtract B from A 

* A* B Multiply A by B 

/ A/B Divide A by B 

N AAB Exponentiation (Raise A to 


the Bth power) 
Unary plus and minus are also allowed, e.g., the - in -A+B or the + in 
+X-Y. , Unary plus is ignored. Unary minus is treated as a zero minus 
the variable, e.g., -A+B would be handled as O-A+B. 
VI. PRIORITY OF ARITHMETIC OPERATIONS 
When more than one operation is to be performed in a single formula, as 


is most often the case, rules are observed as to the precedence of the 
operators. | 
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In any given mathematical formula, BASIC 8001 performs the arithmetic operations 
in the following order of evaluation: | 


1. Parentheses receive top priority. Any expression within 
parentheses is evaluated before an unparenthesized expression. 


2. In the ahasnse of parentheses, the Seaeeice priority ie 
2. Exponentiation (proceeds from left to right). 
b. Unary minus. 
c. Multiplication and Division (of equal priority). 
d. Addition and Subtraction (of equal priority). 
e. Logical operators in the order NOT, AND, then OR. 
3. If either 1 or 2 above does not clearly designate the order of 
priority, then the evaluation of expressions proceeds from 


left to right. 


The expression AaBAC is evaluated from left to right as follows: 


1. AAB step l 
2. (result of step 1)AC = answer 


The expression A/B*C is also evaluated from left to right since multi- 
plication and division are of equal priority: 


1. A/B 


step l 
2. (result of step 1)*C = answer 
The expression A+B*CAD is evaluated as: 


1. CAD step 1 


2. (result of step 1)*B step 2 


3. (result of step 2)+A = answer 
Parentheses may be nested, or enclosed by a second set (or more) of 
parentheses. In this case, the expression within the innermost paren- 
theses is evaluated first, and then the next innermost, and so on, until 
all have been evaluated. 
In the following example: 


A=7* ( (BA2+4) /X) 


The order of priority is: 
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1. Ba2 


2. (result of step 1)+4 
3. (result of step 2)/X 


4. (result of step 3)*7 


Parentheses also prevent any confusion or doubt as to how the expression 


is evaluated. For example: 


A*BA2/7+B/C*DA2 


( (A*BA2) /7+ ( (B/C) *DA2) 


Both of these formulas are executed in the same way, but the second is 
easier to understand. 


Spaces may be used in a similar manner. 


statements: 


19 LET B = DA2 +1 


1@LETB=DA24+1 


Since the BASIC 8001 interpreter 
ignores spaces (except when enclosed in quotation marks), the two 


are identical, but spaces in the first statement provide ease in reading. 
When the statement is subsequently printed, extra spaces are ignored. 


Vite RELATIONAL OPERATORS 


Relational operators allow comparison of two values and 
compare arithmetic expressions or strings in an IF. 
The relational operators are: 


Mathematical BASIC 8001 
Symbol Symbol 
v4 < 
S$ <= or =“ 

> ? 
? >= or =? 
J <? or VS 


The symbols =% =? 
G, =, and <> and 


ADB 


are used to 
THEN statement. 


Meaning 
A is egual to B. 
A is less than B. 


A is less than or 
equal to B. 


A is greater than B. 


A is greater than 
or equal to B. 


A is not equal to B. 


,28& are accepted by BASIC 8001 but are converted to 
are shown in that form in a listing. 
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BASIC 8001 STRINGS 


is STRINGS 


The previous section described the manipulation of numerical information 
only; however, BASIC 8001 also processes information in the form of 
character strings. A string, in this context, is a sequence of characters 
treated as a unit. A string can be composed of alphabetic, numeric, or al- 
phanumeric characters. (An alphanumeric string is one which contains 
letters, numbers, spaces or any combination of characters.) A character 
string can be 255 characters long. Strings cannot be typed on more than 
one terminal line since a carriage return terminates the command. 


Il. STRING VARIABLES 


Any variable name followed by a dollar sign ($) character indicates a 
string variable. For example: 


A$ 
C7$ 


are simple string variables and can be used, for example, as follows: 


LET AS="HELLO" 
PRINT AS 


Note that the string variable AS is separate and distinct from the variable 
A. 


In BASIC 8001, all control characters above control code F (or 6) are legal 
within Quotes (") except for the following: 


Control Code K or 1l or erase line 
Control Code L or 12 or erase page 
Control Code M or 13 or return 
Control Code 2 or 26 or cursor left 


Itt. SUBSCRIPTED STRING VARIABLES 


Any list of matrix variable name followed by the $ character denotes the 
string form of that variable. For example: 


VS (n) M2$ (n) 
CS (m,n) G1$ (m,n) 


where m and n indicate the position of the matrix element within the 
whole. 


The same name can be used as a numeric variable and as a string variable 


in the same program with no restriction. A one- and a two-dimensional 
matrix can have the same name in the same program. For example: 
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A A(n) A(m,n) 
AS AS (m,n) AS (m,n ( 


can all be used in the same program. 


String lists and matrices are defined with the DIM statement as are 
numerical lists and matrices. 


IV. STRING OPERATIONS 
Concatenation 


Concatenation puts one string after another without any intervening 
characters. It is specified by a plus sign (+) and works only with 
strings. The maximum length of a concantenated string is 255 char- 
acters. 


For example: 


18 READ AS, BS, CS 

20 DATA "11", "33", "22" 
39 LET DS = AS+CS+BS 

35 PRINT DS 

4% END 

RUN 

112233 


Vig RELATIONAL OPERATIONS 


When applied to string operands, the relational operators indicate 
alphabetic sequence. The comparison is done on the basis of the ASCII 
value associated with each character in the strings being compared. For 
example: 


55 IF AS<BS THEN 100 


When line 55 is executed, the first characters of each string (A$ and 
BS) are compared, then the second characters of each string and so on 
until the character in AS is less than the character in BS. Then 
execution continues at line 100. Essentially, the strings are compared 
for alphabetic order. The next page contains a list of the relational 
operators and their string interpretations. 


In any string comparison, trailing blanks are ignored (i.e., "ABC" is 
equivalent to "ABC "). 
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Operator 
< 
? 
€= or =€ 
>= or => 
<> or PS 


BASIC 8001 


Relational Operators Used With 
String Variables 


Example Meaning 


AS = BS The strings AS and BS are al- 
phabetically equal. 


AS < BS The string A$ alphabetically 
precedes BS. 

AS > BS The string A$ alphabetically 
follows BS. 

AS <= BS The string A$ is equivalent to 


or precedes BS$ in alphabetical 
sequence. 


AS?= BS The string A$ is equivalent to 
or follows BS in alphabetical 
sequence. 

AS <> BS The strings A$ and BS are not 


alphabetically equal. 
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BASIC 8001 IMMEDIATE MODE 


I. USE OF IMMEDIATE MODE FOR STATEMENT EXECUTION 


It is not necessary to write a complete program to use BASIC 8001. 
Most of the statements discussed in this manual can be included ina 
program for later execution or given on-line as commands, which are 
immediately executed by the 8080 CPU. This latter facility makes 
BASIC 8001 an extremely powerful calculator. 


BASIC 8001 distinguishes between lines entered for later execution 
and those entered for immediate execution solely by the presence (or 
absence) of a line number. Statements which begin with line numbers 
are stored; statements without line numbers are executed immediately 
upon being entered to the system. Thus the line: 


19 PRINT "THIS IS A COMPUCOLOR 8001" 

produces no action at the console upon entry, while the statement: 
PRINT "THIS IS A COMPUCOLOR 8001" 

causes the immediate output: 
THIS IS A COMPUCOLOR 8001 

IIT. PROGRAM DEBUGGING 

Immediate mode operation is especially useful in two areas: program 
debugging and the performance of simple calculations in situations which 


do not occur with sufficient frequency or with sufficient complications 
to justify writing a program. 


In order to facilitate debugging a program, STOP statements can be 
liberally placed throughout the program. Each STOP statement causes 
the program to halt, at which time the various data values can be 
examined and perhaps changed in immediate mode. The 


GO TO xxxxx 


command is used to continue program execution (where xxxxx is the number 
of the next program line to be executed). GOSUB and IF commands could 
also be used. The values assigned to variables when the RUN command was 
executed remain intact until a NEW, CLEAR or another RUN command is 
executed. 


If the STOP occurs in the middle of a FOR loop, modifications cannot be 
made to the section of the program preceding the FOR. 
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When using immediate mode, nearly all the standard statements can be 
used to generate or print results. 


If CTRL/J or linefeed is used to halt program execution, the GO TO XXXX or CONT 
command can be used to continue execution, since CTRL J or linefeed 

does print the number of the line where execution stopped. It is 

easy to know where to resume the program. 


ITI. MULTIPLE STATEMENTS PER LINE 


Multiple statements can be used on a single line in immediate mode. 
For example: 


A=1:PRINT A 
1 


Program loops are allowed in immediate mode; thus a table of square 
roots can be produced as follows: 


FOR I=1 TO 18: PRINT I, SOR (1) :NEXT I 


1 1 
5 1.41421 
3 1.73295 
4 2 
5 2.23697 
6 2.44949 
7 2.64575 
8 2.82843 
9 3 
1g 3.16228 

READY 


IV. RESTRICTIONS ON IMMEDIATE MODE 


The INPUT statement cannot be used in immediate mode and such use results 
in the following error message: 


ID ERROR 
READY 


Certain commands, while not illegal, make no logical sense when used in 
immediate mode. Commands in this category are DEF, DIM and DATA. 


Also since user functions are not defined until the program is executed, 
function references in immediate mode cause an error unless the program 
containing the definition was previously executed. 


Thus, the following dialogue might result if a function was defined in 
a user program and then referenced in immediate mode. 


19 DEF FNA(X) = XA2 + 2*X:REM SAVED STATEMENT 
PRINT FNA(1):REM IMMEDIATE MODE 


UF ERROR 


but if the sequence of statements is: 


10 DEF FNA(X) = XA2+2*X:REM SAVED STATEMENT 
RUN 


READY 


PRINT FNA(1) 
3 


READY 


the immediate mode statement is executed. 
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BASIC 8001 STATEMENTS 


A user program is composed of lines of statements containing instructions 

to BASIC 8001. Each line of the program begins with a line number that identi- 
fies that line as a statement and indicates the order of statement execution. 
Each statement starts with an English word specifying the type of operation 

to be performed. The statement lines are terminated with the RETURN key 

which is non-printing. 


I. STATEMENT NUMBERS 


An integer number is placed at the beginning of each line in a BASIC 8001 
program. BASIC 8001 executes the statements in a program in numerically 
consecutive order regardless of the order in which they were typed. 
Statement numbers must be within the range O to 65529. When first writing 
a program, it is advisable to number lines in increments of five or ten to 
allow insertion of forgotten or additional lines when debugging the program. 


All BASIC 8001 statements and computations must be written on a single line; 
they cannot be continued onto a following line. However, more than one 
statement may be written on a single line when each statement after the 
first is preceded by a colon (:). For example: 


18 INPUT A,B,C 
is a single statement line, whereas 
28 LET X=11: PRINT X,Y,Z: IF X=A THEN 19 


is a multiple statement line containing three statements: LET, PRINT, and 
IF. Most statements may be used anywhere ina multiple statement line; 
exceptions are noted in the discussion of each statement. Only the first 
statement on a line can (and must) have a line number.; It should be re- 
membered that program control cannot be transferred to‘a statement within a 
line, but only to the first statement of a line. 


IIT. REMARK STATEMENT 


It is often desirable to insert notes and messages within a user program. 
Such data as the name and purpose of the program, how to use it, how 
certain parts of the program work, and expected results at various points 
are useful things to have present in the program for ready reference by 
anyone using that program. 


The REMARK or REM statement is used to insert remarks or comments into a 
program without these comments affecting execution. Remarks do, however, 


use core area which may be needed by an exceptionally long program. 


The REMARK statement must be preceded by a line number and may be used 
anywhere in a multiple statement line. The message itself can contain 
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any printing character on the keyboard. BASIC 8001 completely ignores 
anything on a line following the letters REM. (The line number of a REM 
statement can be used in a GOTO or GOSUB statement, see sections pertaining 
to destination of a jump in the program execution.) Typical REM statements 
are shown below: 


10 REM- THIS PROGRAM COMPUTES THE 
ll REM- ROOTS OF A QUADRATIC EQUATION 


III. THE ASSIGNMENT STATEMENT - LET 


The LET statement assigns a value to the specified variable(s). The 
general format of the LET statement is: 


LET variable = expression 


where variable is a numeric or string variable and expression is an 
arithmetic or string expression. All items in the statement must be 
either string or numeric; they cannot be mixed. The word LET is optional. 


The LET statement does not indicate algebraic equality, but performs 
calculations within the expression (if any) and assigns the value to the 
variable. 


The meaning of the equal (=) sign should be clarified. In algebraic 
notation, the formula X=X+l is meaningless. However, in BASIC 8001 (and 
most computer languages), the equal sign designates replacement rather 


than equality. Thus, this formula is actually translated: "add one to 
the current value of X and store the new result back in the same variable 
xX", Whatever value has previously been assigned to X will be combined 


with the value 1. An expression such as A=B+C instructs the computer to 
add the values of B and C and store the result in a third variable A. The 
variable A is not being evaluated in terms of any previously assigned value, 
but only in terms of B and C. Therefore, if A has been assigned any value 
prior to its use in this statement, the old value is lost; it is instead 
replaced by the value B+C. 


Example: 
LET X=2 Assigns the value 2 to the variable X. 
LET X=X+1+Y Adds 1 to the current value of X then adds the 
value of Y to the result and assigns that value 
to X. 


IV. THE DIMENSION STATEMENT - DIM 


The DIMension statement is used to define the maximum number of elements 
in a matrix. The DIM statement is of the form: 


DIM variable(n), variable(n,m), variableS(n), variableS (n,m) 


where variables specified are indicated with their maximum subscript value(s). 
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For example: 


1g DIM X(5), ¥(4,2), A(1P ,19) 
12 DIM A4(19%), A$(25) 


Only integer constants (such as 5 or 5070) can be used in DIM statements 
to define the size of a matrix. Variables cannot be used to specify the 
bounds of arrays. Any number of matrices can be defined in a single DIM 
statement as long as their representations are separated by commas. 


The first element of every matrix is automatically assumed to have a sub- 
script of zero. Dimensioning A(6,10) sets up room for a matrix with 7 
rows and 11 columns. This zero element is illustrated in the following 
program: 


19 REM - MATRIX CHECK PROGRAM 
28 DIM A(6,19) 

38 FOR I=% TO 6 

49 LET A(I,g) = I 

5% FOR J=% TO 19 

69 LET A(@,J) = J 

7% PRINT A(I,J); 

8% NEXT J:PRINT:NEXT I 

99 END 


Om BW NH EQ 
QQaaaer 
ine aaracie 
QRQQQAES Ww 
QQQRQA 
QeQeQVeVeeau 
QQAQQQQO 
QRQQVee~ 
QQ O 
QaQQaQaao 
QOH 


READY 


Notice that a variable has a value of zero until it is assigned another 
value. 


Whenever an array is dimensioned (n,m), the matrix is allocated mtl, ntl 
elements. Core space can be conserved by using the Oth element of the 
matrix. For example, DIM A(5,9) dimensions a 6 x 10 matrix which would 
then be referenced beginning with the A(0,0) element. 


The size and number of matrices which can be defined depend upon the 
amount of storage space available. 


A DIM statement can be placed anywhere in a multiple statement line and 
can appear anywhere in the program. A matrix can only be dimensioned 
once. DIM statements need not appear prior to the first reference to an 
array, although DIM statements are generally among the first statements 

of a program to allow them to be easily found if any alterations are later 
required. 
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All arrays specified in DIM statements are allocated space when the RUN 
command is executed. 


V. PLOT STATEMENT 


The PLOT Statement is used to output the 8 bit BYTE value of an expression 
to the CRT Screen. The general format of the PLOT Statement is: 


10 PLOT expression 


The expression can be any combination of variables which will evaluate 
to a positive value between O and 255. 


The following example will plot a point on the CRT Screen at Location 
80, 96 (X,Y): 


10 X=80 : Y=96 

20 PLOT 2 : REMARK THE 8001 PLOT MODE CODE 

30 PLOT X : PLOT Y : REMARK PLOTS POINT AT 80, 96 

40 PLOT 255 : REMARKS THE 8001 PLOT MODE ESCAPE CODE 
As another example enter: 

PLOT 65 

A 

READY 


It can be seen that (since 65 is the decimal ASCII value for A) PLOT 65 
is the same as PRINT "A". 


VI. PRINT STATEMENT 


The PRINT statement is used to output data to the terminal. The general 
format of the PRINT statement is: 


1) PRINT list 
The list is optional and can contain expressions, text strings, or both. 
When used without the list, the PRINT statement: 

25 PRINT 


causes a blank line to be output on the 8001 CRT Screen (a carriage return/ 
line feed operation is performed). 


2) PRINT Expression 
PRINT statements can be used to perform calculations and print results. 


Any expression within the list is evaluated before a value is printed. 
For example: 
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19 LET A=1 : LET B=2: LET C=3+A 
2¢ PRINT 

39 PRINT A+B+C 

RUN 


7 


READY 
All numbers are printed with a preceding and following blank space. 


The PRINT statement can be used anywhere in a multiple statement line. 
For example: 


19 A=1l: PRINT A: A=A+5: PRINT: PRINT A 
prints the following on the terminal when executed: 
1 


6 

READY 
Notice that the terminal performs a carriage return/line feed at the end 
of each PRINT statement. Thus the first PRINT statement outputs a 1 and 


a Carriage return/line feed; the second PRINT statement the blank line; 
and the third PRINT statement, a 6 and another carriage return/line feed. 


3) PRINT Strings 


The PRINT statement can be used to print a message or string of characters, 
either alone or together with the evaluation and printing of numeric values. 
Characters are indicated for printing by enclosing them in double quotation 
marks. For example: 


18 PRINT "TIME'S UP" 
28 PRINT "NEVERMORE" 
RUN 
TIME'S UP 
NEVERMORE 
READY 
As another example, consider the following line: 
4% PRINT "AVERAGE GRADE IS";X 


which prints the following (where X is equal to 83.4): 


AVERAGE GRADE IS 83.4 
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When a character string is printed, only the characters between the 
quotes appear; no leading or trailing spaces are added. Leading and 
trailing spaces can be added within the quotation marks using the key- 
board space bar; spaces appear in the printout exactly as they are typed 
within the quotation marks. 


When a comma separates a text string from another PRINT list item, the 
item is printed at the beginning of the next available print zone. 
Semicolons separating text strings from other items are ignored. Thus, 
the previous example could be expressed as: 


4% PRINT "AVERAGE GRADE IS" X 


and the same printout would result. A comma or semicolon appearing as 
the last item of a PRINT list always suppresses the carriage return/line 
feed operation. 


BASIC 8001 does an automatic carriage return/line feed if a string is 
printing past column 80. 


4) Use of "," and ";" 


BASIC 8001 considers the 8001 CRT Screen to be divided into ten zones of 
eight spaces each. When an item in a PRINT statement is followed by a 
comma, the next value to be printed appears in the next available print 
zone. For example: 


19 LET A=3: LET B=2 
29 PRINT A,B,A+B,A*B,A-B,B-A 


When the preceding lines are executed, the following is printed: 
3 2 5 6 1 ~l 
Notice each character is 8 spaces from the next character. 


Two commas together in a PRINT statement cause a print zone to be skipped. 
For example: | 


19 LET A=1/ LET B=2 

29 PRINT A,B, ,A+B 

RUN 

1 2 3 


READY 
If the last item in a PRINT statement is followed by a comma, no carriage 


return/line feed is output, and the next value to be printed (by a later 
PRINT statement) appears in the next available print zone. For example: 


29 


19 A=1:B=2:C=3 
28 PRINT A, :PRINT B: PRINT C 
RUN 

1 2 

3 


READY 


If a tighter packing of printed values is desired, the semicolon 
character can be used in place of the comma. A semicolon causes no 
further spaces to be output other than the leading and trailing space 
automatically output with each number. A comma causes the print head 
to move at least one space to the next print zone or possibly perform 
a carriage return/line feed. The following example shows the effects 
of the semicolon and comma. 


19 LET A=1/ B=2/ C=3 
28 PRINT A;B;C; 

38 PRINT A+1;B+1;C+1 
4Q PRINT A,B,C 

RUN 


Ed 33. 22: . 38> 48 
1 2 3 


READY 


The following example demonstrates the use of the formatting characters , 
and ; with text strings: 


129 PRINT "STUDENT NUMBER"X, "GRADE ="G;"AVE. ="A; 
138 PRINT "NO. IN CLASS ="N 


could cause the following to be printed (assuming calculations were done 
prior to line 130): 


STUDENT NUMBER 119%5@ GRADE = 87 AVE. = 85.44 NO. IN CLASS = 26 

5) PRINT Statement - TAB Function 
The TAB function is used in a PRINT statement to write spaces to the spec- 
ified column on the output device. The columns on the output devices are 
numbered 1 to 80. 
The form of the command is: 


PRINT TAB (x) 


where (x) is the column number in the range 0-255. (If X exceeds 80, 


however, every other consecutive line is tabbed until the number of 
spaces to be output is less than or equal to 80). If the column number 


specified is greater than 255 or negative, an error message is printed 
as follows: 


CF ERROR 
READY 
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If (x) is non-integer, only the integer portion of the number is 
used. 


Tf the column number (x) specified is less than or equal to the 
current column number, the TAB function has no effect. 


VII. INPUT STATEMENT 


The INPUT statement is used when data is to be input from the terminal 
keyboard during program execution. The form of the statement is: 


1) INPUT list 
where list is a list of variable names separated by commas. 
For example: 

18 INPUT A,B,C 


causes the computer to pause during execution, print a question mark, 
and wait for input of three numeric values separated by commas. The 
values are input to the computer by typing the RETURN key. 


If too few values are entered, BASIC 8001 prints another ? to indicate 
that more data is needed. If too many values are typed, the excess 

data on that line is ignored and the message below is printed but program 
still continues. The values entered in response to the INPUT statement 
cannot be continued on another line and are terminated by the RETURN 

key. Values must be separated by commas, if more than one value is 

input on the same line. 


When there are several values to be entered via the INPUT statement, 
it is helpful to print a message explaining the data needed. For 
example: 


1g PRINT "YOUR AGE IS"; 
29 INPUT A 


2) INPUT "string"; list 


The INPUT statement can also contain quoted strings. The above example 
could be written: 


10 INPUT "YOUR AGE IS?";A 
Note that when a quoted string is included in a INPUT statement, the 
normal ? is not printed as a prompt character, and if desired, must 


be included as shown within the quotes above. 


This feature allows BASIC 8001 to be programmed to handle fill-in-the- 
forms type of applications. 
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VIII. DATA STATEMENT 


The DATA statement is used in conjunction with the READ statement to 
enter data into an executing program. One statement is never used 
without the other. The form of the statement is: 


DATA value list 


where the value list contains the numbers or strings to be assigned to 
the variables listed in a READ statement. Individual items in the value 
list are separated by commas; strings must be enclosed in quotation 
marks. 


For example: 


15% DATA 4,7.2,3,"ABC" 
179 DATA 1,34E-3, 3.17311 


The location of DATA statements is arbitrary as long as they appear in 
the correct order; however, it is good practice to collect all DATA 
statements near the end of the program. 


When the RUN command is executed, BASIC 8001 searches for the first DATA 
statement and saves a pointer to its location. Each time a READ statement 
is encountered in the program, the next value in the data statement is 
assigned to the designated variable. If there are no more values in that 
DATA statement, BASIC 8001 looks for the next DATA statement. 


IX. READ STATEMENT 


A READ statement is used to assign the values listed in a DATA statement 
to the specified variables. The READ statement is of the form: 


READ variable list 


The items in the variable list may be simple variable names or string 
variable names and are separated by commas. For example: 


1@ READ A, BS, C(1) 
20 DATA 12, "12",.12E2 


Since data must be read before it can be used in a program, READ statements 
generally occur near the beginning of the program. A READ statement can be 


placed anywhere in a multiple statement line. 


If there is no data available in the data table for the READ to store, the 
out of data message below is printed: 


OD ERROR IN xXxxxx 
READY 


Items in the data list in excess of those needed by the program's READ 
statements are ignored. 
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X. RESTORE STATEMENT 


The RESTORE statement causes the program to reuse the data from the 
first DATA statement and is of the form: 


RESTORE 
For example: 
3% RESTORE 


causes the next READ statement following line 30 to begin reading data 
from the first DATA statement in the program, regardless of where the 
last value was found. 


A further example of the use of RESTORE follows: 


15 READ B,C,D 


55 RESTORE 
6% READ E,F,G 


89 DATA 6,3,4,7,9,2 


199 END 


The READ statements in lines 15 and 60 both read the first three data 
values provided in line 80. (If the RESTORE statement had not been 
..inserted before line 60, then the second READ would pick up data in 
line 80 starting with the fourth value.) 


Since the values are being read as though for the first time, the same 

variable names may be used the second time through the data, if desired. 
To skip unwanted values, replacement, or dummy, variables may be inserted. 
For example: 


1 REM - PROGRAM TO ILLUSTRATE USE OF RESTORE 
2 READ N 

25 PRINT "VALUES OF X ARE:" 

38 FOR I=1 TO N 

48 READ X 

5% PRINT X, 

69 NEXT I 

7% RESTORE 

185 PRINT 

19% PRINT "SECOND LIST OF X VALUES" 

209 PRINT "FOLLOWING RESTORE STATEMENT: " 
219 FOR I=l TON 

229 READ X 

23% PRINT X, 

249 NEXT I 33 


258 DATA 4,1,2 
251 DATA 3,4 
390 END 


RUN 
VALUES OF X ARE: 

1 2 3 4 
SECOND LIST OF X VALUES 
FOLLOWING RESTORE STATEMENT: 

4 1 2 3 
READY 


The second time the data values are read, the first X picks up the 
value originally assigned to N in line 20, and as a result, BASIC 
prints: 


4 1 2 3 


To circumvent this, a dummy variable could be inserted to pick up and 
store the first value. This variable would not be represented in the 
PRINT statement, so the output would be the same each time through 
the list. 


XI. GOTO STATEMENT 


The GOTO statement is used when it is desired to unconditionally transfer 
to some line other than the next sequential line in the program. [In 
other words, a GOTO statement causes an immediate jump to a specified 

line, out of the normal consecutive line number order of execution. The 
general format of the statement is as follows: 


GOTO line number 


The line number to which the program jumps can be either greater or less 
than the current line number. It is thus possible to jump forward or 
backward within a program. 


For example, 


1@ LET A=2 

28 GOTO 5¢ 

38 LET A=SOR(A+14) 
5@ PRINT A,A*A 
RUN 


causes the following to be printed: 

2 4 
When the program encounters line 20, control transfers to line 50; line 
50 is executed, control then continues to the line following line 50. 


Line 30 is never executed. Any number of lines can be skipped in either 
direction. 
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When written as part of a multiple statement line, GOTO should always 
be the last statement on the line, since any statement following the 
GOTO on the same line is never executed. For example: 


XII. 


11% LET A=ATN(B2) :PRINT A:GOTO 597 


IF-THEN, IF-GOTO STATEMENTS 


The IF-THEN statement is used to transfer conditionally from the normal 
consecutive order of statement numbers, depending upon the truth of some 
mathematical relation or relations. The basic format of the IF statement 
is as follows: 


THEN 


IF expression rel.op. expression line number 


GOTO 


where expression is an arithmetic or string expression. 


rel. 


Oop. 


line number 


Expressions cannot be mixed; both must be string 

or both must be numeric. Numeric comparisons are 
handled as described in the ARITHMETIC Section. String 
comparisons are performed on the ASCII values of 

the strings as described in the STRING Section. 


is one of the operators described in the ARITHMETIC 
Section. 


is the line of the program to which control is 
conditionally passed. 


If the value of the expression is true, control passes to the line number 
specified. 


If the value of the expression is false, control passes to the next state- 
ment in sequence. 


Examples: 


XIIlf. 


1@ IF A=B THEN 2@:PRINT "A B" 


15 STOP 
20 PRINT A+B 


19 IF A<D>1G GOTO 2M :PRINT A 


15 STOP 
2% D=A+B*C 


19 IF AS€BS THEN 2@:STOP 


2% PRINT AS 


FOR-NEXT STATEMENTS 


FOR and NEXT statements define the beginning and end of a loop. (A loop 
is a set of instructions which are repeated over and over again, each time 
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being modified in some way until a terminal condition is reached.) 
The FOR statement is of the form: 


FOR variable = expressionl TO expression2 STEP expression3 
where 
variable must be a nonsubscripted numeric variable. 


expression is an arithmetic expression which may be non- 
integer, 


The variable is the index; expressionl is the initial value; expression2, 
the terminal value and expression3, the increment value. 


For example: 
15 FOR K=2 TO 29 STEP 2 


causes the program execution of the designated loop as long as K is 
less than or equal to 20. Each time through the loop, K is incremented 
by 2, so the loop is executed a total of 10 times. When K=20, program 
control passes to the line following the associated NEXT statement. 


The index variable must be unsubscripted, although a common use of such 
loops is to deal with subscripted variables using the control variable 
as the subscript of a previously defined variable. The expressions in 
the FOR statement can be any acceptable BASIC 8001 expression. 


The NEXT statement signals the end of the loop which began with the 
FOR statement. The NEXT statement is of the form: 


NEXT variable 


where the variable is the same variable specified in the FOR statement. 
Together the FOR and NEXT statements define the boundaries of the 

program loop. When execution encounters the NEXT statement, the computer 
adds the STEP expression value to the variable and checks to see if the 
variable is still less than or equal to the terminal expression value. 
When the variable exceeds the terminal expression value, control falls 
through the loop to the statement following the NEXT statement. Note 

the variable is not necessary since when a NEXT statement is encountered 
it is assumed it is for the appropriate FOR loop variable. 


If the STEP expression and the word STEP are omitted from the FOR state- 
ment, +l is the assumed value. Since +l is a common STEP value, that 
portion of the statement is frequently omitted. 


The expressions within the FOR statement are evaluated once upon initial 
entry to the loop. The test for completion of the loop is made after 
each execution of the loop. (If the test fails initially, the loop is 
still executed once.) 
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The index variable can be modified within the loop. When control falls 
through the loop, the index variable retains the value used to fall through 
the loop. 


The following is a demonstration of a simple FOR-NEXT loop. The loop 
is executed 10 times; the value of I is 11 when control leaves the loop; 
and +l is the assumed STEP value: 


19 FOR I=1 TO 19 
28 PRINT I 
38 NEXT I 
48 PRINT I 


The loop itself is lines 10 through 30, The numbers 1 through 10 are 
printed when the loop is executed. After I=10, control passes to line 
40 which causes 11 to be printed. If line 10 had been: 

18 FOR I = 18 TO 1 STEP -1 


the value printed by line 40 would be @. 


19 FOR I = 2 TO 44 STEP 2 
20 LET I = 44 
3 NEXT I 


The above loop is only executed once since the value of I=44 has been 
reached and the termination condition is satisfied. 


If the initial value of the variable is greater than the terminal value, 
the loop is still executed once. The loop set up by the statement: 


18 FOR I = 2M TO 2 STEP 2 


will be executed only once although a statement like the following will 
initialize execution of a loop properly: 


19 FOR I=2% TO 2 STEP -2 


For positive STEP values the loop is executed until the control variable 
is greater than its final value. For negative STEP values, the loop 
continues until the control variable is less than its final value. 


FOR loops can be nested but not overlapped. The depth of nesting depends 
upon the amount of user storage space available (in other words, upon the 
size of the user program and the amount of RAM available). Nesting is a 
programming technigue in which one or more loops are completely within 
another loop. The field of one loop (the numbered lines from the FOR 
statement to the corresponding NEXT statement, inclusive) must not cross 
the field of another loop. 
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ACCEPTABLE NESTING UNACCEPTABLE NESTING 
TECHNIQUES TECHNIQUES | 


Two Level Nesting 


FOR Il = 1 TO 10 FOR Il = 1 TO 10 

FOR I2 = 1 TO 10 FOR I2 = 1 TO 10 

NEXT 12 NEXT Il | 
Co I3 = 1 70 10 NEXT I2 

NEXT 13 

NEXT I1 


Three Level Nesting 


FOR Il = 1 TO 10 FOR Il = 1 TO 10 
FOR I2 = 1 TO 10 FOR I2 = 1 TO 10 
ce 13 = 1 TO 10 FOR I3 = 1 TO 10 
NEXT I3 NEXT 13 
pre T4 = 1 TO 10 ps T4 = 1 TO 10 
NEXT I4 NEXT 14 
NEXT I2 NEXT I1 
NEXT I1 NEXT I2 


An example of nested FOR-NEXT loops is shown below: 


5 DIM X(5,12) 

19 FOR A=1 TO 5 

20 FOR B=2 TO 1% STEP 2 
30 LET X(A,B)= A+B 

AS NEXT B 

58 NEXT A 

55 PRINT x(5,19) 


When the above statements are executed, BASIC 8001 prints 15 when line 
55 is processed. | 


It is possible to exit from a FOR-NEXT loop without the control variable 

reaching the termination value. A conditional or unconditional transfer 

can be used to leave a loop. Control can only transfer into a loop which 
had been left earlier without being completed, ensuring that termination 

and STEP values are assigned. | 


Both FOR and NEXT statements can appear anywhere in a multiple statement 
line. For example: | 


19 FOR I=l TO 1@ STEP 5:NEXT I: PRINT "I=";1 
causes: 
I=l1l 


to be printed when executed. 
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XIV. GOSUB AND RETURN STATEMENTS 


A subroutine is a section of code performing some operation required 
at more than one point in the program. Sometimes a complicated I/O 
operation for a volume of data, a mathematical evaluation which is too 
complex for a user-defined function, or any number of other processes 
may be best performed in a subroutine. 


More than one subroutine can be used in a single program, in which 
case they can be placed one after another at the end of the program 
(in line number sequence). A useful practice is to assign distinc- 
tive line numbers to subroutines; for example, if the main program 
uses line numbers up to 199, use 200 and 300 as the first numbers of 
two subroutines. 


Subroutines are usually placed physically at the end of a program 
before DATA statements, if any- The program begins execution and 
continues until it encounters a GOSUB statement of the form: 


1) GOSUB line number 


where the line number following the word GOSUB is that of the first 
line of the subroutine. Control then transfers to that line of the 
subroutine. For example: 


58 GOSUB 299 


Control is transferred to line 200 in the user program. The first 
line in the subroutine can be a remark or any executable statement. 


Having reached the line containing a GOSUB statement, control trans- 
fers to the line indicated after GOSUB; the subroutine is processed 
until BASIC 8001 encounters a RETURN statement of the form: 


2) RETURN 


which causes control to return to the statement following the original 
GOSUB statement. A subroutine must always be exited via a RETURN 
statement. 


Before transferring to the subroutine, BASIC 8001 internally records the 
next sequential statement to be processed after the GOSUB statement; 

the RETURN statement is a signal to transfer control to this statement. 

In this way, no matter how many subroutines there are or how many times 

they are called, BASIC 8001 always knows where to transfer control next. 
The following program demonstrates the use of GOSUB and RETURN. 


1 REM - THIS PROGRAM ILLUSTRATES GOSUB AND RETURN 
1g DEF FNA(X)= ABS (INT(X) ) 
28 INPUT A,B,C 


38  GOSUB 182 
Ag LET A=FNA (A) 
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59g LET B=FNA (B) 

6B LET C=FNA(C) 

7B PRINT 

8Z GOSUB 192 

99 STOP 

199 REM - THIS SUBROUTINE PRINTS OUT THE SOLUTIONS 
118 REM - OF THE EQUATION: AXA2 + BX + C= Q@ 
128 PRINT "THE EQUATION IS "A "*XA2 + " BU*X + "C 
138 LET D=B*B —- 4*A*C 

148 IF D<€>0 THEN 172 

158 PRINT "ONLY ONE SOLUTION... X "; -B/(2*A) 

168 RETURN 

17% IF D<P THEN 29 

188 PRINT "TWO SOLUTIONS...X ="; 

185 PRINT (-B+SOR(D))/(2*A); ") AND ("; (-B-SQR(D))/(2*A) 
199 RETURN : 


2008 PRINT "IMAGINARY SOLUTIONS ...X=("; 

285 PRINT -B/(2*A) "," SOR(-D)/(2*A) ") AND ("; 
287 PRINT -B/(2*A) ","; -SOR(-D)/(2*A) ")" 

218 #$RETURN | 

99% END 


Subroutines can be nested; that is, one subroutine can call another 
subroutine. If the execution of a subroutine encounters a RETURN 
statement, it returns control to the line following the GOSUB which 
called that subroutine. Therefore, a subroutine can call another 
subroutine, even itself. Subroutines can be entered at any point 

and can have more than one RETURN statement. It is possible to trans- 
fer to the beginning or any part of a subroutine; multiple entry points 
and RETURN's make a subroutine more versatile. Up to 20 levels of 
GOSUB nesting are allowed. | 


XV. END STATEMENT 


The END statement is the last statement in a BASIC program, aad is of 
the form: 


END 
The line number of the END statement must be the largest line number 
in a given program, since any lines having line numbers greater than 
that of the END statement are not executed (although a are saved 
with the SAVE command). 


The END statement is optional. When an END statement is executed, 
program execution stops and the READY message is printed. 


XVI. STOP STATEMENT 
The STOP statement can occur several times throughout a single program 
with conditional jumps determining the actual end of the program. The 


STOP statement is of the form: 


90 STOP 


40 


and causes: 


BREAK IN 90 
READY 


to be printed when executed. 


This signals that the execution of a program has been terminated and 
BASIC 8001 is able to accept further input. 
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BASIC 8001 FUNCTIONS 


ARITHMETIC FUNCTIONS 


BASIC 8001 provides functions to perform certain standard mathematical 
operations such as square roots, logarithms, etc. 


These functions have three or four letter call names followed by 
a parenthesized argument. They are pre-defined and may be used 
anywhere in a program. | 
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Call Name Function 
ABS (x) Returns the absolute value of x. 
ATN (x) Returns the arctangent of x as an 
angle in radians in range + or -pi/2. 
CALL (x) CALL the user, machine language program 
at location GAG@@ Hex. 
COS (x) Returns the cosine of x radians. 
EXP (x) Returns the value of e* where e=2.71828. 
FRE (x) Returns number of free BYTES not in use. 
INT (x) Returns the greatest integer less than 
or equal to x, (INT(-.5)=-1). 
INP (x) Returns a BYTE from input port 0<x<255. 
LOG (x) Returns the natural logarithm of x. 
PEEK (x) Returns a BYTE from memory address 0<x<32767 
or if x is negative the memory address is 
65536-x. 
POS (x) Returns a value of current cursor positions 
between O and 79. 
RND (x) Returns a random number between O and l. 
SGN (x) Returns a value indicating the sign of x. 
SIN (x) Returns the sine of x radians. 
SPC (x) Causes x spaces to be generated. 
SOR (x) Returis the square root of x. 
TAB (x) Causes the 8001 CRT to space over to column 
number x. Valid in PRINT statement only. 
TAN (x) Returns the tangent of x radians. 


The argument x to the functions can be a constant, a variable, an 
expression, or another function. A square bracket cannot be used as 
the enclosing character for the argument x, e.g. SIN [x] is illegal. 


Function calls, consisting of the function name followed by a paren- 
thesized argument, can be used as expressions or as elements of 
expressions anywhere that expressions are legal. 


Values produced by the functions SIN(x), COS(x), ATN(x), SOR(x), EXP( 
and LOG(x) have six significant digits. 


I. Sine and Cosine Functions, SIN(x) and COS (x) 


The sine and cosine functions require an argument angle expressed in 
radian measure. If the angle is stated in degrees, conversion to 
radians may be done using the identity: 


gradians> = <degrees> * (pi/180) 


In the following example program, 3.14159 is used as a nominal value 
for pi. P is set equal to this value at line 20. At line 40 the 
above relationship is used (in the expression within the LET statemer 
to convert the input value into radians. 


1g REM - CONVERT ANGLE (X) TO RADIANS, AND 

11 REM - FIND SIN AND Cos 

20 LET P = 3.14159 

25 PRINT "DEGREES", "RADIANS", "SINE", "COSINE" 

39 INPUT x 
Ag LET y = x*P/180 

6% PRINT xX, Y, SIN(Y), COS(Y) 

7% GOTO 30 
RUN 
DEGREES RADIANS SINE COSINE 
2D 

g i) i") i 

219 

19 .174533 .173648 . 984888 
229 

20 . 349966 . 34292 . 939693 
239 

39 .523598 5 . 866926 
2369 

369 6.28318 -5.24319E-96 1 

245 

A5 . 785398 . 797196 . 787197 
299 

99 1.5798 1 1.12352E-96 
?RETURN : 
READY 
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Il. Arctangent Function, ATN(x); Tangent Function, TAN (x) 


The arctangent function returns a value in radian measure, in the range 
+pi/2 to -pi/2 corresponding to the value of a tangent supplied as the 
argument (X). a, 


In the following program, input is an angle in degrees. Degrees are 
then converted to radians at line 40. 


At line 70 the tangent value, Z, is supplied as argument to the ATN 
function to derive the value found in column 4 of the printout under 
the label ATN(X). Also in line 70 the radian value of the arctangent 
function is converted back to degrees and printed in the fifth column 
of the printout as a check against the input value shown in the first 
column. 


19 LET P= 3.14159 
28 PRINT "SUPPLY AN ANGLE IN DEGREES" 


25 PRINT "ANGLE", "ANGLE", "TAN(X)", "ATAN(X)", "ATAN(X)" 
26 PRINT "(DEGS)","(RADS)",,,"(DEGS)" 
3 INPUT xX 


4 LET Y = X*P/189 
5% LET Z = TAN(Y) 
7% PRINT X,Y,Z,ATN(Z) ,ATN(Z) *180/P 


85 PRINT 
98 GOTO 3¢ 
RUN 
SUPPLY AN ANGLE IN DEGREES 
ANGLE ANGLE TAN (X) ATAN (X) ATAN (X) 
(DEGS) (RADS) (DEGS) 
22 
0) Z i) 1) i) 
' 245 
45 . 785398 .999999 . 785398 45 
?1¢2 
10 .174533 .176327 .174533 1g 
? (RETURN) 
READY 
Tif. Square Root Function, SQR(x) 


This function derives the square root of any positive value as shown 
below. 


1g INPUT x 
29 LET X = SOR(X) 
39 PRINT X 
48 GOTO 19 
RUN 
216 

4 

2199 

19 

?1999 


A4 


31.6228 
2123456789 
11111.1 
?17 
4.12311 
?25E2 

5g 
21972 
44.3847 
? (RETURN) 
READY 


IV. Exponential Function, EXP (x) 


The exponential function raises the number e to the power x. EXP is 
the inverse of the LOG function. The relationship is 


LOG (EXP(X)) = X 


The following program prints the exponential equivalent of an input 
value. Note that the output values derived below are used as input to 
the LOG function. 


19 INPUT x 
2 PRINT EXP (xX) 
AZ GOTO 19 


RUN 
24 

54.5981 

219 

22926.5 
29.421906 
12345 
2?4.69517 

199 

225 

7. 2GG49E+1¢ 
? (RETURN) 
READY 


Vs Logarithm Function, LOG(x) 


The LOG function derives the logarithm to the base e of a given value. 
In the following program at line 20, the LOG function is used to 
convert an input value to its logarithmic equivalent. 


(19 INPUT x 
29 PRINT LOG(X) 
38 GOTO 19 


RUN 

~ 2?54.59815 
4, 
?22626.47 


1p 45 


212345 
9.42191 
2199 
4.69517 

?. 72GG49E11 
25 

? (RETURN) 

READY 


Logarithms to the base e may easily be converted to any other base 
using the following formula: 


log,N 
log,N= : 
Og,a 


where a represents the desired base. The following program illustrates 
conversion to the base 10. 


1 REM - CONVERT BASE E LOG TO BASE 19 LOG. 

5 PRINT "VALUE","BASE E LOG","BASE 1 LOG" 

15 INPUT x 

17 PRINT X, 

28 PRINT LOG(X), 

4% PRINT LOG(X) /LOG(1Q) 

5@ GOTO 15 

68 END 
RUN 
VALUE BASE E LOG BASE 1% LOG 
24 

A 1.38629 .6B2G6 
2259 

259 5.52146 2.39794 
25 

5 1.69944 .69897 
?69 | 
69 4.99434 1.77815 
?129 

189 4.69517 2 
? (RETURN) 
READY 


An attempt to do a LOG(0) or LOG of a negative number causes the 
CF error message. . 


VI. Absolute Function, ABS (x) 
The ABS function returns an absolute value for any argument value. 


Absolute value is always positive. In the following program, various 
input values are converted to their absolute values and printed. 
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1g INPUT x 
20 LET X = 
30 PRINT xX 
4g GOTO 19 
/RUN 
?-35.7 
35.7 
?2 
2 
225E19 
2.5999GE+11 
2195555567 
1.95556E+98 
219.12345 
10.1234 
?-44 .555566668899 
44.5556 
? (RETURN) 
READY 


VII. Integer Function, INT(x) 


The integer function returns the value of the greatest integer not 
greater than x. For example: 


PRINT INT (34.67) 
34 


PRINT INT (-5.1) 
-6 


The INT of a negative number is a negative number with the same or 
larger absolute value, i.e., the same or smaller algebraic value. 
For example: 


PRINT INT (-23.45) 
-24 


PRINT INT(-14.39) 
-15 


PRINT INT(-11) 
-1ll 


The INT function can be used to round numbers to the nearest integer, 
using INT(X+.5). For example: 


PRINT INT (34.67+.5) 
35 


PRINT INT(-5.1+.5) 
-5 
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INT(x) can also be used to round to any given decimal place or 
integral power of 10, by using the following expression as an 
argument: 


(X*10fTD+.5)/10 D 
where D is an integer supplied by the user. 


19 REM - INT FUNCTION EXAMPLE 

15 PRINT 

28 PRINT "NUMBER TO BE ROUNDED:" 
25 INPUT A 

4% PRINT "NO. OF DECIMAL PLACES:" 
45 INPUT D 

69 LET B = INT(A*10AD + .5)/1QaD 
78 PRINT "A ROUNDED = " B 

88 GOTO 15 

99 END 

RUN 


NUMBER TO BE ROUNDED: 


2?55.65842 
NO. OF DECIMAL PLACES: 
22 


A ROUNDED = 55.66 


NUMBER TO BE ROUNDED: 
278.375 

NO. OF DECIMAL PLACES: 
?-2 

A ROUNDED = 199 


NUMBER TO BE ROUNDED: 
267.38 

NO. OF DECIMAL PLACES: 
2-1 

A ROUNDED = 79 


NUMBER TO BE ROUNDED: 
? (RETURN) 
READY 


VIII. Random Number Function, RND(x) 


The random number function produces a random number, or random number 
set, between 0 and 1. The numbers are reproducible in the same order 
after ESC, E key if X»0 for later checking of a program. The argument (x) 
is not used and can be any number (it cannot be a string expression); it 
serves only to standardize all BASIC 8001 function representations. The 
form RND is not legal. For example: 
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18 REM — RANDOM NUMBER EXAMPLE. 


25 PRINT "RANDOM NUMBERS: 


39 FOR I = 1 TO 15 
4% PRINT RND(1) 

5@ NEXT I 

6% END 

RUN 


RANDOM NUMBERS: 
.199259.59438 
. 306121. 299946 
.985412.27376 


READY 


. 964813. 9267824 
.285553.599886 
.522186.791146 


.636444 .569123 
-179351.469434 
.777861.457448 


.839919.729921 
.452117.433291 
459592 .30797 


.886627 . 388994 
-958221.744955 
-246246.599584 


To obtain random digits from 0 to 9, change line 40 to read: 


49 PRINT INT(10*RND(1)), 


and run the program again. 
as follows: 


RUN 

RANDOM NUMBERS : 

8 9 8 9 
5 4 4 1 
READY 


This time the results will be printed 


It is possible to generate random numbers over a given range. If 
the open range (A,B) is desired, use the expression: 


(B-A) *RND(1)+A 


to produce a random number in the range A<n<B. 


The following program produces a random number set in the open range 
4,6 (the extremes, 4 and 6, are never reached). 


18 REM - 
28 FOR B 
30 LET A = 
4 PRINT A, 
5% NEXT B 
6% END 


1 To 15 
(6-4) * RND(1) +4 


RUN 

4.29954.59266 5.929624.29985 
4.612245.33f46 4.571194.26695 
4.197985.99934 5.944374.82533 


READY 


RANDOM NUMBER SET IN OPEN RANGE 4,6. 


5.773255.54926 5.272884.76248 5.678945.25946 
5.916445.69965 4.358795.54721 4.994235.65g21 
4.492495.61498 5.555694.41632 4.991185.91598 
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NOTE: Negative arguments, i.e., RND(-x) will start a new random 
number sequence. While RND (@) will always generate the last random 


number. 


IX. Sign Function, SGN(x) 


The sign function returns the value lif x isa positive value, Dg 


if x is O and -l if x is negative. 


PRINT SGN (3.42) 
1 


PRINT SGN (-42) 
~l 


PRINT SGN (23-23) 
DB 


For example: 


The following example program illustrates the use of the SGN function. 


19 REM-SGN FUNCTION EXAMPLE. 


28 READ A,B,C 


25 PRINT "A = "A,"B = "B,"C = "C 


3% PRINT "SGN(A) ="SGN(A), 
48 PRINT "SGN(C) ="SGN(C) 

5@ DATA -7.32, .44, @ 

68 END 

RUN 

A= -7.32 B= .44 C=Q 


SGN(A) =-1 SGN(B) =l SGN(C) 


READY 


Xs Call Statement 


"SGN(B) ="SGN(B), 


B 


The CALL statement can be inserted anywhere in the BASIC 8001 program 


and has the form: 
CALL (expression) 


Where expression 


is the argument to the assembly 
language routine. The argument 
may be an expression. This may 
include values passed to the user 
routine. 


The CALL statement causes a jump to location AOOO HEX, which, unless 
modified by the user, contains a jump to the CF ERROR routine. The 
user must modify these three locations to go to his routines. 
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BASIC 8001 FUNCTIONS 


USER DEFINED FUNCTIONS 


In some programs it may be necessary to execute the same sequence of 
statements or mathematical formulas in several different places. 
BASIC 8001 allows definition of unique operations or expressions and 
the calling of these functions in the same way as the square root or 
trig functions. 


These user-defined functions consist of a function name: the first 
two letters of which are FN followed by a third or a fourth letter. 
For example: 


legal illegal 
FNA FNAS 
FNAA FN2 
FNAL 


Fach function is defined once and the definition may appear anywhere 
in the program. The defining or DEF statement is formed as follows: 


DEF FNa (argument) = expression (argument) 
where a is a variable name. The argument may consist of a dummy variable 
and the number of arguments is limited to one variable. The expression 
may contain other program variables not among the argument variable. 
For example: 

10 DEF FNA(S) = Sa2 
causes a later statement: 

28 LET R = FNA(4)41 


to be evaluated as R=17. As another example: 


5% DEF FNB(A) = A+XA2 
69 Y=FNB (14) 


causes the function to be evaluated with the current value of the 
variable X within the program. 


The two following programs 
Program #1: 
18 DEF FNS(A) = AaA 
28 FOR I=1 TO 5 
38 PRINT I, FNS(TI) 


4$ NEXT I 
5% END 
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Program #2: 


19 DEF FNS(X) = Xax 
29 FOR I=1 TO 5 

39 PRINT I, FNS(TI) 
48 NEXT I 

5% END 


cause the same output: 


RUN 

1 1 

2 4 

3 27 

4 256 
5 3125 
READY 


The argument in the DEF statement can be seen to have no significance; 

it is strictly a dummy variable. (A DEF statement with no arguments is 
illegal.) The function itself can be defined in the DEF statement in 
terms of numbers, variables, other functions, or mathematical expressions. 
For example: 


18 DEF FNA(X) = XA2+3*X+4 
28 DEF FNB(X) = FNA(X)/2 + FNA(X) 
30 DEF FNC(X) = SOR(X+4)+1 


The statement in which the user-defined function appears can have that 
function combined with numbers, variables, other functions, or mathe- 
matical expressions. For example: 
48 LET R = FNA(X+Y+Z) *N/ (YA2+D) 
A user-defined function cannot have several arguments, as shown below: 
25 DEF FNL(X,Y,Z) = SQOR(XA2 + YA2 + ZA2) 


will cause an error 


SN ERROR IN 25. 
READY 


When calling a user-defined function, the parenthesized arguments can be 
any legal expressions. The value of each expression is substituted for 
the corresponding function variable. For example: 

1@ DEF FNZ(X)=XA2 

29 LET A=2 

38 PRINT FNZ(2+A) 


line 30 causes 16 to be printed. 
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If the same function name is defined more than once, then the last 
definition will be used. The program below 


18 DEF FNX(X)=XA2 
20 DEF FNX(X)=X+X 
39 LET A=5 

48 PRINT FNX(A) 


will cause 10 to be printed. 


The function variable need not appear in the function expression as 
shown below: 


10 DEF FNA (X) = 4 +2 
20 LET R = FNA(10)+1 
30 PRINT R 

40 END 

RUN 

7 
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BASIC 8001 FUNCTIONS 


STRING FUNCTIONS 


Like the intrinsic mathematical functions (e.g., SIN, LOG), BASIC 8001 
contains various functions for use with character strings. These 
functions allow the program to concatenate two strings, access part of 
a string, determine the number of characters ina string, generate a 
Character string corresponding to a given number or vice versa, search 
for a substring within a larger string, and perform other useful 
operations. The various functions available are summarized in the 
following table. 


String Functions 


Function code Meaning 


ASC (x$) Returns the seven-bit internal code for the 
one-character string (x$) as a decimal num- 
ber. If the argument contains more than 
one character, then the first character in 
the string is returned. 


CHRS (x) Generates a one-character string having the 
ASCII value of x where x is a number greater 
than or equal to O and less than or equal to 
255. For example: CHRS(65) is equivalent 


to "A". Only one character can be generated. 
FRE (x$) Returns number of free string BYTES. 
LEFTS (x$,I) Returns left most I characters of string 
| (x$). 

LEN (x$) | Returns the number of characters in the 
string x$ (including trailing blanks). For 
example: 

PRINT LEN (AS) 
26 
MIDS (x$,I,J) Returns the string of characters in position 


I through J in x$. a gL eg ge em pt nes 
¢ 4 af 


RIGHTS (x$ ,I) Returns right most I characters of string 
(x$). 
STRS (x) Returns the string which represents the 


numeric value of x as it would be printed by 
a PRINT statement but without a leading or 
trailing blank. 
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VAL(xS) Returns the number represented by the string 
xS. If xS does not represent a number, then 
Y value is returned. 


In the above examples, xS and yS represent any legal string expressions, 
and I and J represent any legal arithmetic expressions. 


User-Defined String Functions 


Character string functions cannot be written in the same way as numeric 
functions. 
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BASIC 8001 EDITING COMMANDS 


BASIC 8001 provides several key commands which can be used to halt 
program execution, erase characters or delete lines. The below table 
provides an explanation of each of the key commands. 


Key Commands 


Key Explanation 
CTRL/J Interrupts execution of a command or program. 
or LINEFEED BASIC 8001 prints the message 


or ay 
| BREAK IN XXX 
READY 


A control command is typed by holding down 
the CTRL key while typing the letter key. 


CTRL/M or RETURN Must be typed to end every line typed in 
or to indicate the end of an INPUT. 


CTRL/K Deletes the entire current line (provided 
‘or the RETURN key has not been typed). 
ERASE LINE BASIC 8001 displays: 


Erased line and CR. 


CTRL/Z Deletes the last character typed and echoes 
or CURSOR LEFT | as a cursor left on the terminal. Spaces 
or &— as well as characters or control codes may 


be erased. 


: A colon is used to separate multiple 
statements per line. 


CTRL/L Erases CRT screen but does not change 
Or ERASE PAGE any BASIC 8001 statements. 


If the RETURN key has already been typed, a program line can be corrected 
by typing the appropriate line number and retyping the line correctly. 


The line can be deleted by typing the RETURN key immediately after the 
line number; removing both the line number and line from the program. 


If the line number of a line not needing correction is accidentally typed, 
the cursor left key (CTRL Z) may be used to delete the number(s); then the 
correct number can be typed. Assume the line: | 


19 IF A>5 GO TO 239 
is correct. A line 15 is to be inserted, but: 

19 LET 
is typed by mistake. The correction is made as follows: 

18 LET@#¢€¢5 LET X=X-3 
Line 10 remains unchanged, and line 15 is entered. 
Following an attempt to run a program, error messages may be output 
on the terminal indicating illegal characters or formats, or other 
user errors in the program. Most errors can be corrected by typing 
the line number(s) and the correction(s) and then rerunning the pro- 
gram. As many changes or corrections as desired may be made before 
runs. 
The following editing commands are entered in immediate mode and 
terminated by the RETURN key. These commands are used to erase a 
program in RAM, and list, punch or run a program. 
Lz NEW COMMAND 
The NEW command clears current contents of the storage area set up 


by BASIC 8001. This deletes any commands, programs, arrays, strings 
or symbols currently stored by BASIC 8001. 


NEW should be used before entering a new program from the terminal 
keyboard to be sure no old program lines will be mixed into the new 


program and to clear out the symbol table area. 


Example: 


Clears the storage area and inserts the program being input at the 
keyboard. | | 


Il. LIST COMMAND 


The LIST command prints the user program currently in core on the 
terminal. 


A part of a program may be listed by typing LIST followed by a line 


number. This causes that line and all following lines in the program 
to be listed. 


5/7 


Type CTRL/J or linefeed key to halt the listing. BASIC 8001 returns 
to the READY message when the current line is finished. 


The lines listed may differ slightly from those entered because: 


il. Certain characters while acceptable to BASIC 8001 are stored 
in a standard manner. 


Character Character 
Typed Stored 
= > >= 
>< <? 


2. Literals are stored to 24 bits of accuracy. Those with more 
than 24 bits are truncated to 24 bits. 


3. Although literal storage is 24 bits, output is truncated to 
6 decimal digits. 


4. Literals are output in standard BASIC 8001 format, regardless of 
how they were input; for example, 


18 LET X=3.94+1. 9909291 
2 PRINT X-E7 

LIST | 

19 LET x=3+1 

26 PRINT X-1.90GSPE+B7 


5. Spaces in the input program are ignored, except within 
strings and REM statements. The LIST command prints the 
program with a space inserted to separate the key word and 
the line number. The listed program is therefore easier 
to read. 

Example: 
LIST 199 
Lists line 100 and all remaining lines in the program. 


i Ee Ha SAVE COMMAND 


The SAVE command outputs the program in RAM to the specified device. 
The form of the command is: 


SAVE A 
The format of the program output by the SAVE command is exactly the 


same as that stored in RAM memory. It may be recalled by the same > 
file name using the LOAD command. 
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IV. RUN COMMAND 


After the user program is entered into RAM, it can be executed by 
typing the command 


RUN 
and the RETURN key. 
The program is scanned; arrays are created in core and then the program 
is executed. Any appropriate error messages are printed and when the 


END or STOP statement is encountered, execution halts and a message is 
printed. 


After execution, the variables used in a program remain accessible for 
use in immediate mode until a NEW, CLEAR or another RUN command is 
executed. 


V. CLEAR COMMAND 
The CLEAR command clears the contents of the user array and string 
buffers. This command is generally used when a program has been exe- 
cuted and then edited. Before it is rerun, the array and string buffers 
are set to zeros and nulls by the CLEAR command to provide more core. 
These buffers will be filled again when the RUN command is executed. 
Example: 

18 A=1¢ 

2% PRINT A 

CLEAR 


READY 


RUN 
1p 


READY 

VI. CLEAR X COMMAND 
The CLEAR X performs the same function as CLEAR without the argument, 
but the Argument X reserves X locations for string variables which are 
required in string calculations. Normally this is 50 locations unless 
changed by CLEAR X command. | 

Vil. CONTINUE COMMAND 
Continues program execution after a Control J or line feed is typed or 


a STOP statement is executed. You cannot continue after any error, after 
modifying your program or before your program has been run. 


5? 


One of the main purposes of CONT is debugging. Suppose at some point 
after running your program, nothing is printed. This may be because 
your program is performing some time-consuming calculation, but it may 
be because you have fallen into an "infinite loop". An infinite loop 

is a series of BASIC 8001 statements from which there is no escape. 

The BASIC 8001 will keep executing a series of statements over and 

over until you intervene or until power to the unit is cut off. If 

you suspect your program iS in an infinite loop, type in a Control J 

or line feed. The line number of the statement BASIC 8001 was executing 
will be typed out. 


After BASIC 8001 has typed out READY, you can use PRINT to type out 
some of the values of your variables. After examining these values, 
you may become satisfied that your program is functioning correctly. 
You should then type in CONT to continue executing your program where 
it left off, or type a direct GOTO statement to resume execution of 
the program at a different line. 


You could also use assignment (LET) statements to set some of your 
variables to different values. Remember, if you line feed or Control 
J your program and expect to continue it later, you must not get any 
errors or type in any program lines. If you do, you won't be able to 
continue, and get a "CN" (continue not) error. . It is impossible to 
continue a direct command. CONT always resumes execution at the next 
statement to be executed in your program when Control J or line feed 
was typed. 


VIII. LOAD I COMMAND 


LOADS the program named I from the 8001 CPU operating system Reader 
Input port specified by the I/O BYTE at location 9F90 HEX, see the 
CPU O.S. Manual. A new command is automatically done before the 
LOAD I command is executed. When finished loading the READY command 
will appear as usual. If the unit can't find the file on the floppy 
tape, then an error message should appear. 


IX. LOAD?I COMMAND 
Does same as LOAD I except that a NEW command is not performed and 
BASIC 8001 does a word-by-word comparison of file I with the program 


already existing in RAM memory. If they are the same, then READY 
appears, else 


VERIFY FAILURE 
READY 


will appear. 
This should always be used after saving a program with the SAVE I 


command to ensure that it was saved correctly and can be reloaded 
without error. 


60 


USING ASSEMBLY LANGUAGE 


ROUTINES WITH BASIC 


BASIC 8001 has a facility which allows experienced 8080 assembly 
language programmers to interface their own assembly language 
routines to BASIC 8001. This facility permits the user to add 
functions to BASIC 8001 which can operate directly on special 
purpose peripheral devices. This section describes in some detail 
the internal characteristics of BASIC 8001 during the execution of 
a BASIC 8001 program, and is intended to serve as a programming 
guide for the creation of such user-coded assembly language functions. 
This material assumes the user is familiar with 8080 assembly 
language. For additional information on this subject, refer to an 
assembly language programming manual on the 8080 CPU. 


The CALL statement is used to reference these assembly language 
routines from the BASIC 8001 program. 
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TERMS: 


TERM 


Address 


Bit 


Byte 


Console 


Instruction 


Object Program 


Program — 


source Program 


System Program 


--TERMS AND ABBREVIATIONS-- 


DESCRIPTION 


A 16 bit number assigned to a memory location 
corresponding to its sequential position. 


The smallest unit of information which can 
be represented. (A bit may be in one of 
two states, O or l). 


A group of 8 contiguous bits occupying a 
Single memory location. 


Refers to the 8001 CRT Display as the 
output device, and the 8001 keyboard 
as the input device. Allows operator 
interface with the CPU operating system. 


The smallest single operation that the 
computer can be directed to execute. 


A program which can be loaded directly into 
the computer's memory and which requires no 
alteration before execution. An object 
program is usually on paper tape, and is 
produced by assembling (or compiling) a 
source program. Instructions are re- 
presented by binary machine code in an 
object program. 


A sequence of instructions which, taken as 
a group, allow the computer to accomplish a 
desired task. 


A progam which is readable by a programmer 
but which must be transformed into object 
program format before it can be loaded into 
the computer and executed. Instructions in 
an assembly language source program are 
represented by their assembly language 
mnemonic. 


A program written to help in the process of 
creating user programs. 


TERMS -- (Continued): 


TERM 


User Program 


DESCRIPTION 


A program written by the user to make the 
computer perform any desired task. 


Word A group of 16 contiguous bits occupying _ 
two successive memory locations. (2 bytes). 
ABBREVIATIONS : 
ABBREVIATION DESCRIPTION 
Cy Carriage return 
CPU Central Processing Unit 
Lf Line feed 
PROM Programmable Read Only Memory 
Sp Space Bar 
nnn B nnn represents a number in binary format. 
nnn D nnn represents a number in decimal format. 
nnn O nnn represents a number in octal format. 
nnn Q nnn represents a number in octal format. 
nnn H nnn represents a number in hexadecimal format. 
Shaded portions of CPU/operator dialog repre- 
sent Console output. 
CPU 0.S. COMMANDS AND MESSAGES 
2.0 CPU OPERATING SYSTEM (0O.S.) 
STARTING ADDRESS - 100 When in 8708 ERASABLE PROM 


All arguments are in hexadecimal form. 


B SO BACK TO CRT O.S. 


D DISPLAY IN HEXADECIMAL FORMAT 

D low address, high address 

Memory from low address to high address is displayed in hexadecimal 
form. 

E END 

E address 

Endfile mark is created; 60 null characters are written on 

punch device 

F FILL MEMORY 

F low address, high address, data 


Memory from low address to high address is filled with data. 


G GO TO 

G Address, bkptl, bkpt2 

Program control is transferred to address. Breakpoints are set at 
bkptl and bkpt2. When break points are executed, all of the CPU 
registers are automatically displayed. 

H HEXADECIMAL ARITHMETIC 


H number, number sp 


The sum and difference of the two numbers is printed in hexadecimal. 


L LOAD HEXADECIMAL TAPE 
L Bias address 


A hexadecimal format tape is read into memory at tape address plus 
bias address. 


M MOVE 

M low address, high address, destination address 

A block of memory from low address to high address is moved 
to location destination address. 

N PUNCH NULL 

N 


Sixty null characters are punched. 


R BAUD RATE FOR SECOND RS-232 CHANNEL 

R rate number 

The rate number must be between 1 and 7. See the "How to Use the 8001" 
Manual. 

S SUBSTITUTE 

S address Sp 

Memory at address is displayed, and can be modified by typing 
in new data. Termination with space opens next sequential 
address, termination with carriage return ends command. 

X EXAMINE REGISTERS OR MEMORY 

X reg ident 


Register is displayed, and can be modified as in the S command. 


W WRITE HEXADECIMAL 
W low address, high address 


Memory from low address to high address is punched in hexadecimal 
format. 


MESSAGES 
‘ CPU O.S. ready to accept commands 
2 Error. Reenter command 


3.0 INTECOLOR® 8001 CONFIGURATION 


3.1 I/O SYSTEM 


The Intecolor® 3001 can support a number of input/output devices, 
from the CRT display and the RS232C I/O to devices supplied by 

the user. In general, it may be convenient to have two devices 
which can perform the same function, but to use them for different 
purposes at various times. For example, if a program is being assembled, 
you might want the program listing to be written on one device, while 
any system messages not relevant to the assembly would be written ona 
Separate device. 


The 1.0 system described below permits this type of change. Devices 
may be assigned functions via the System Monitor S command (see Section 
4.2.11) or via the user's program. That is, it is possible to write 
programs which read from several different input devices and write to 
several different output devices of the program's choosing, without re- 
quiring any human intervention. 


Siecde dL LOGICAL AND PHYSICAL DEVICES 


Regardless of how many I/O devices a particular Intecolor® 8001 

has, there are only four operations which can be performed to 

any of them. For example, a WRITE operation can be performed 

either to the RS232C channel 1 to a host computer or a high speed 

tape system. All system programs and user-written programs, therefore, 
access four LOGICAL DEVICES (i1.e., a WRITE device) which are then trans- 
lated to a PHYSICAL DEVICE (i.e., a high speed tape) by the I/O 

system. 


The four logical devices available to programs are: 


CONSOLE An interactive, character-oriented device used 
for both input and output. 


READER A character-oriented, input-only device which 
transfers data on command and signals the 
program when where is no more data (an end-of- 
file condition). 


WRITE A character-oriented, output-only device which 
accepts a character from the program and re- 
cords it on some external medium. 


LLST A character-oriented, output-only device which 
accepts a character from the program and records 
it on some external medium in human readable form. 


Each of these four logical devices may be associated with one of 
four physical devices at any instant, giving a total of 16 phys- 


ical devices. 


The mapping from logical to physical devices is 


specified by an I/O status byte which resides in memory and is 


accessible to system and user programs via substitute command. _ 
The address of the I/O status byte is 9F9@hex. A pointer to 


~9EAH 


the I/O status byte is also contained in memory locations %%36 


and @%37 (low byte of pointer, high byte of pointer). 


mappings appear as follows: 


T/O Status Byte: 


Initially 
AJA. = LIST FIELD A,Ao= 
A-A, = PUNCH FIELD AA,= 
LOGICAL DEVICES I/O DEV FIELD 
CO 
Ol 
~ CONSOLE 10 
11 
00 
—— 
Ol "Ps 
READER “Sh 


The possible 


CONSOLE FIELD > 


READER FIELD 


PHYSICAL DEVICES 
RS232 Channel 1 
RS232 Channel 2 


CR Tube = Console Output 
Keyboard= Console Input 


(user console device) 


= 
RS232Z Channel 1 
- 


ae 


r 


“ R§232 Channel 2 


“Ss. Keyboard 


eee = 
he 


(user reader device 1) 


& 
SS 
Ses 
‘, <. 
Ss 


LOGICAL DEVICES I/O DEV FIELD PHYSICAL DEVICES 


00 RS232 Channel 1 

O1 RS232 Channel 2 
WRITE 

10 CR Tube 

11 (user punch device 1) 

00 RS232 Channel 1 

Ol RS232 Channel 2 
LIST 

10 CR Tube 

11 (user list device 1) 


At cold start or system reset, the I/O status byte is set equal 

to 82H, causing the CR Tube and keyboard to be selected for console 
T/O and LIST, while the RS232 Channel 1 is selected for both READ 
and WRITE. 


Be ee I/O SUBROUTINES 


The way in which a program performs an I/O operation to any of 
the four logical devices is by calling the appropriate sub- 

routine supplied by the I/O system. The available subroutines 
and their iocations in memory are given in the following table: 


ROUT!.NE FUNCTION _ MEMORY LOCATION 
cI Console input 103H 
CC Console Output 109H 
F. Reader input 106H 
rO Punch output 10CH 
LO List output 1LOFH 
SO Console String Output 12AH 


The rest of this section gives a description and examples of 
how to call these subroutines. 


CI - CONSOLE INPUT | 


This routine returns a character received from the selected 
console device to the caller in the A register. The A regis- 
ter and the condition bits are affected by this operation. 


Example: 


Assembly Language 


CALL CI 
STA DATA 


CO - CONSOLE OUTPUT 


CO transmits a character, passed from the calling program in 
the A register, to the device selected for console output. The 
A register and the condition bits are affected. 


Example: 


Assembly Language 


MVI Aye 
CALL CO ;PRINT '.' ON CONSOLE 


RI - READER INPUT 


RI returns a character read from the reader device in the A 
register. If no character was read from the device (i.e., 

end of file), the CARRY condition bit is set equal to 1, and 
the A register is zeroed. If data is ready, the CARRY bit is 
zeroed. If no character is received from the physical device 
then striking any key causes an end of file to be simulated and 
control is returned to the calling program. 


Example: 


Assembly Language 


CALL RI 
JC EOF ; END OF FILE SENSED 
STA DATA 


PO -— WRITE OUTPUT 


PO transmits a character from the calling program to the device 
selected as the punch device. PO is identical in format to CO. 


LO - LIST OUTPUT 


LO performs the same function to the selected list device as 
CO and PO do to their selected devices. 


SO - CONSOLE STRING OUTPUT 


SO transmits a character string to the device selected for console 
output. A pointer to the beginning of the string is passed from 
the calling program in the HL register pair. The string should be 
terminated by a byte having the value 239 (decimal). SO also pro- 
vides repeat loops of the form: ..., 237, N, Dl, D2, ..., DM, 238, 
--- where N is the repeat count for the string of bytes Dl 
through DM. 


Example: 
Assembly Language 


oe e @ 


LXI H, STR 
CALL SO 


STR: DB ‘AB', 237, 3, 'CD', 238, ‘'EFG', 239 


This example will print 'ABCDCDCDEFG' on the console device. 


FLOPPY TAPE I/O SUBROUTINES 


Three I/O subroutines are provided for the Intecolor Floppy Tape. 
These routines are: 


ROUTINE FUNCTION MEMORY LOCATION 
TWR Write to Floppy Tape @136H 
TRD Read from Floppy Tape @133H 
TVE Compare memory with Floppy Tape @136H 


The Floppy Tape is a block-transfer device. One record is written 
per track. The inputs from the calling program to each of the 
three I/O routines are: 


HL register pair - pointer to memory buffer 


DE register pair - byte count 


A register - Tape drive/track code: 
BIT3 - DRIVE: @or l 
BITS2-@ - Track: @ through 7 


After calling any one of the routines, the A register will contain a 
status code and will have been tested (ORA A): 


A=6 : No Errors 
A=2 : Keyboard Abort (Pressing any key on the 
keyboard during the data transfer will 
abort the operation) 
A=4 : Buffer too large for write. 
A=6 : Buffer too small for read. 
A=8 : Read Failure: A complete, correctly 
formatted record could not be read 
from the tape. 
A=10 : Checksum error. 
A=12 : Verify failure. A mismatch was detected between 
| data in memory and data read from the tape 
during a memory compare operation (TVF). 


Also, after calling any of the routines, the HL register pair 
will point one byte past the last byte manipulated in the memory 
buffer. 


Soles USER-SUPPLIED DEVICES 


This section describes the necessary steps in hooking up a 
user-supplied I/O device to the I/O system. 


The I/O subroutines described in Section 3.3.2 assume that 
programs (called drivers) exist which perform the actual 
transfer of data between I/O devices and the CPU. For in- 
stance, when the console input routine is called, it checks 
to see which physical device is assigned to the console, 
and then branches to the driver appropriate to the device 
Therefore, when the user supplies his own device, he must: 


1) Write a program to perform the data transfer, 
making sure that the program saves and restores 
any CPU registers it uses that are not specifi- 
cally changed by the I/O subroutine. 


LO 


2) Store a JMP to this driver's address in the 
appropriate location as defined in the 
following table: 


MEMORY LOCATION USE 
9F 91H USER DEFINED CONSOLE INPUT 
OF 94H USER DEFINED CONSOLE OUTPUT 
9F 97H USER DEFINED READER (1) 
OF 9AH USER DEFINED WRITE (1) 
OF 9DH USER DEFINED LIST (1) 


Thus, if the user supplied a custom built listing device, he would 
write a driver to transfer data to it in an appropriate manner, 
then store the JMP to the driver's address at location 9F9DH. By 
assigning LIST=3, his device would receive any listing output 
generated. | 


4.0 . CPU OPERATING SYSTEM 


The Intecolor 8001 CPU 0.S. enables the operator to easily 
manipulate the contents of memory, read and produce MAG 
tapes, and execute programs. | 


The CPU O.S., and all Intecolor® 8001 system software in 

general, use the last 80 memory locations after the refresh 
area for storage of temporary data. Therefore, if the opera- 
tor runs a program beginning in these locations, and then uses 
the CPU O.S. Text Editor, or Assembler, he must re-load these 

80 bytes of his program before running it again. Alternatively, 
programs could be written beginning at any higher location. 

Then system programs and user programs could be executed in 

any order, without regquiring the re-load operation. 


For a 25tline system these locations are 8FBOH to 8FFFH. 
The 48 line system uses locations 9FBOH to 9FFFH. 


The CPU 0O.S. is the operator's interface to the 8080 CPU, and 
controls loading and execution of user programs, and to some 
extent the debugging of user programs. Figure 4-1 illustrates 
memory utilization during various stages of system software 
use. While the CPU O.S. is running, it uses an area at the 
top of memory for data storage and scratch work. 


fa 


4.1 CPU OPERATING SYSTEM IMPLEMENTATION AND EXECUTION 


4.1.1 CPU O.S. IMPLEMENTATION 


‘The Intecolor 8001 CPU O.S. program is implemented on two 

E PROM modules, which are pre-installed into each Intecolor 8001 
with Option 34. This allows the CPU to be used with great 

ease, aS it is not necessary to wait for lengthy paper-tape 
loading operations. All that is required to go on-line with 
CPU O.S. is to turn the Intecolor 8001 on, hit the ESCAPE 

key, and then the CPU O.S. key, and begin execution. 


4.1.2. STARTING SYSTEM MONITOR 


To begin operating the CPU O.S., press two keys in sequence, 
"ESCAPE', (CPU O.S.) and the Intecolor 8001 will automatically 
jump to the starting address of the CPU O.S. 


4.2 CPU O.S. OPERATION AND COMMANDS 


The commands consist of a single letter typed into the 
Intecolor® 8001 keyboard followed by a number of arguments, 
possibly none. The arguments are separated, if there are 
more than one, by spaces or commas. A command is terminated 
and executed by typing a carriage return or space, depending 
upon the command. 


4.2.1 B COMMAND (BACK TO CRT 0O.S.) 


4.2.2 D COMMAND (DISPLAY DATA) 


The format of the D command is: 
D low address, high address 


Low address is a valid 16 bit memory address. 


LZ 


High address is a valid 16 bit memory address equal to or 
greater than low address. 


Description: Upon execution of this command, memory data 
from (low address) to (high address) is displayed upon the 
list device (normally the CR tube). Data are displayed in 
hexadecimal form. Up to sixteen bytes per line are printed, 
preceded by the hexadecimal address of the first byte of 

that line. A carriage return is forced after a byte having a 
low order digit of F in its memory address is printed. 


Example: Enter at the keyboard the command: 
-DLOF, 123 (Cr) 
and the CR Tube will display: 
O10F AA 
0110 BB CC DD EE FF 11 22 33 44 55 66 77 88 99 AB CD 
0120 EF 12 34 56 


where memory locations O1LOF through 0123 are assumed to contain 


AA BB CC DD EE FF ll 22 33 44 55 66 77 88 99 AB CD EF 
12 34 56 


the D command should be used only to examine memory contents. To 
punch the memory contents onto a tape, the W command should be 
used. These commands produce a tape in the proper formats, while 


the D command causes a simple sequence of characters to be 
output. 


Error conditions: 
1. If low address or high address is greater than 16 bits, 
only the last 4 hex digits of the argument will be used 
-as the address. 
Example: The command 
-D30010,AB0013 (Cr) 
is equivalent to the command 
-DO0010,0013 (Cr) 


2. If low address is greater than high address, only the 
one byte at low address will be displayed. 
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Example: The command: 


-D1O,6 
is equivalent to the command 
-D10,10 
oe Non-existent memory is equivalent to a string of bytes 


all containing FF H. 


Example: If memory address 2000 H- 2010 H are invalid, then 
the command: 


-D2000,2010 
will cause the teletype to print: 
2000 FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 


2010 FF 


4. If low address or high address contains an invalid 
character, or if high address is omitted, the CR Tube 
will immediately display '?(Cr) (1f). and await the 
next command. 


Example: If the user attempts to enter the number OG as an 
address, the following will be displayed: 


- DOG? 


4.2.3 F COMMAND (FILL MEMORY WITH CONSTANT) 


The format of the F command is: 
F low address, high address, data 
Low address is a valid 16 bit memory address. 


High address is a valid 16 bit memory address equal to or 
greater than low address. 


Data is an 8 bit data value. 
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Description: Execution of this command causes memory locations 
(low address) through (high address) to be filled with the 
constant (data). 
Example: The command: 

.F7,14,AA (Cr) 


will set bytes 0007 through 0014 equal to AA H. 


0007 AA AA AA AA AA AA AA AA AA 
OO1LO AA AA AA AA AA 


Error Conditions: 

I. If low address of high address is greater than 16 bits 
(or data is greater than 8 bits), only the last 4 (or 2) 
hex digits will be used. 

Example: The command: 

-F7AB0007, 0014, FFACAA (Cr) 
is equivalent to the command: 
-FQ007,0014,AA (Cr) 
Z's If low address is greater than high address, data will 


replace only the byte at low address. 


Example: If locations 7, 8, and 9 contain AA H, BB H, and CC H, 
execution of the command: 


ly pikes 3 tCu) 
will cause memory to appear as follows: 
0007 33 BB CE 


ce If a non-existent memory address is specified, this 
command has no effect. 


4. If low address, high address, or data contain an invalid 
character, the CR Tube will immediately display '? (Cr) (1f).' 
and await the next command. 


Example: If the user tries to enter BO as data, the following 
will be displayed: 


.FO012,14,BQ? 
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4.2.4 G COMMAND (GO TO) 


The format of the G command is: 
G address, bkptl, bkpt2 


Address, bkptl, and bkpt2 are valid 16 bit hexadecimal memory 
addresses. 


Description: The G command causes program control to be trans- 
ferred to location address. If either bkptl or bkpt2 is specified, 
a breakpoint will be set in the program at the corresponding 
address(es). The specified address must correspond to the first 
byte of a program instruction. If either breakpoint is en- 
countered during program execution, the CPU O.S. will save and 
display all program status (CPU registers and condition bits), 
clear all existing breakpoints, and take control. The user may 
then examine and/or modify registers or memory, or use any other 
monitor commands. This feature allows the user to debug por- 
tions of a program. 


If address is not specified, the program status is restored 
and the saved value of the program counter is used as the new 
starting address. 

Example: The command: 


G24A 


will cause program execution to begin at location 24AH, with 
no breakpoints being set. 


The command: 

G,12C 
will cause a breakpoint to be set at 12CH, and program execution 
to resume at the address indicated by the saved value of the 
program counter. 
The command: 

G 
will cause program execution to resume at the address indicated 


by the saved value of the program counter, with all status 
restored and no breakpoints set. 
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Error Conditions: 


Le If address is greater than 16 bits, only the last 4 
hex digits of the argument will be used as the address. 


Example: The command: 
-G3CO010 (Cr) 
is equivalent to the command 
-GOO10 (Cr) 
2 If address is a non-existent memory address, the system 
will attempt to transfer control and then return to the 


CRT O.S. with no response. The CPU O.S. must then be 
manually restarted. 


4.2.5. H COMMAND (HEXADECIMAL ARITHMETIC) 


The format of the H command is: 
-H number, number Sp 
Number is a 16 bit hexadecimal number. 


Description: The H command is designed to aid the user in 
performing hexadecimal arithmetic while using the CPU O.S. 

It causes the sum and difference it arguments to be displayed 
in two-s complement hexadecimal form. This command is termi- 
nated by a space, rather than by a carriage return. 


Example: 
sHle 7 oC OO7A FFC2 
Error Conditions: 
1. If either number is greater than 16 bits, only the last 


4 hex digits are used. 
Example: The command: 
- HOOABC , 23Sp 
is equivalent to the command: 


-HOABC, 23Sp 
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2. If number contains an invalid character, the CR Tube 
will immediately display '?(Cr) (1f).' and await the 
next command. : 


Example: If the user attempts to enter O1lP, the following will 
be displayed: 


sHOLP? 


4.2.6 I COMMAND (RESET CRT TO STATE So) 


The format of the I command is: 


I causes the same action as the CPU reset key 
being typed. 


As2.7 L COMMAND (LOAD HEXADECIMAL FILE) 


The format for the L command is: 


L bias address 


Bias Address is a 16 bit two's complement hexadecimal number. 


Description: This command loads tape written in hexadecimal 
format (uSing the W command) into memory. The address at which 
the tape is loaded is determined by adding the address on the 
tape to the bias address using two's complement arithmetic. 

The bias may be negative, but in this case must be in two's 
complement form. If the tape was produced using an E command 
with a non-zero entry point address (see section 4.2.11), 
control will be transferred to that location in memory. Other- 
wise, the CPU 0.S. will remain in control and request another 
command. 


Example: If a tape was used which began at location O100 H, 
the following command: 


-LFFBO (Cr) 


will cause the tape to be read and loaded into location 50 H. 
(1000+FFBO=50). 
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NOTE: If an error occurs while reading the tape (such as a 
checksum error), the CPU O.S. will immediately stop reading 

the tape, display '?(Cr) (Lf£).' and await the next command. 

The operation may be retried by backing up the tape to any 
point before the last colon and issuing another L command, 
Since each data word specifies the address at which it is to be 
loaded. The CPU O.S. will read up to the first colon it en- 
counters, and then begin loading data. 


Note that this means that, if you wish to change data in 
locations in memory, it is not necessary to regenerate an 
entirely new tape with the change; instead you may read in 
the original tape, then read in a patch tape which reloads 
only the erroneous locations. 


Error Conditions: 


oe If the bias address is greater than 16 bits, only the 
last 4 hex digits are used as the bias address. 


Example: The command: 
-LOOFFBO (Cr) 
is equivalent to the command: 
.LFFBO (Cr) 
2a If an invalid character is present in the bias address, 
the CR Tube will immediately display '*(Cr) (If).' and 
await the next command. 


Example: If the user attempts to enter GOO as a bias address, 
the following will be displayed: 


- RG? 


4.2.8 M COMMAND (MOVE MEMORY) 


The format of the M command is: 


-M low address, high address, 
destination address 


Low address is a valid 16 bit memory address. 


High address is a valid 16 bit memory address equal to or 
greater than low address. 
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Destination address is a valid 16 bit memory address. 
Description: The M command causes the block of memory from 
low address through high address to be moved to the locations 
in memory beginning at destination address. 

Example: If memory appears as follows: 


LOCATIONS DATA 


0300-0304 contain 01020304 
0200-0204 contain A1A2A3A4 


Then the command: 
M200,204, 300 
will cause the following: 
LOCATIONS DATA 
0300-0304 contain A1A2A3A4 


0200-0204 contain A1lA2A 3A4 


Note: The movement is performed byte by byte: the byte at 

low address is moved to destination address, then low address 

+1 is moved to destination address+l, etc. Therefore, the 

MOVE command may be used to fill memory with a byte or sequence 

of bytes. 

Example: If location 0300 H contains FF H, the command 
-M300,310,301 (Cr) 

will cause locations 300 through 310 to contain FF H. The FF 

at 300 is moved to 301, then the byte at 301 (which is now FF), 

is moved to 302, and so on. 


Error Conditions: 


dis If any address is greater than 16 bits, only the 
last 4 hex digits are used as the address. 


Example: The command: 
-M00302,303,00405 (Cr) 
is equivalent to the command: 


M302,303,405 (Cr) 
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2% If low address is greater than high address, only 
one byte will be moved from low address to destina- 
tion address. 
Example: The command: 
.M300, 2FO,100(Cr) 
is equivalent to the command: 
-M300, 300,100 (Cr) 
3. If low address through high address specifies a non- 
existent range of memory, bytes of FF H will be moved 


to the memory locations specified by destination address. 


Example: If locations 2000 H through 2005 are non-existent, 
the commend: 


-M2000, 2005, 100 (Cr) 


will cause locations 0100 H through 0105 H to contain FF H. 


4. If an invalid character is entered in an address, the 


CR Tube will display '?(Cr) (1f).' and await the next 
command. 


Example: If the user attempts to enter OBAG as the destination 
address, the following will be displayed: 


M100, 10F , OBAG* 


4.2.9. R COMMAND (BAUD RATE SELECT) 
The format of the R command is 
R rate value 


The rate value must be between 1 and 7. See chart below. 


NUMBER 

RATE 
HIGH SPEED 1200 |2400 | 9600 | 19,200/38,400 |76,800 
BAUD RATE 


ZA: 


4.2.10 S COMMAND (SUBSTITUTE MEMORY) 


The S command is used to display and/or modify the contents 
of individual memory locations. It is used as follows: 


ik Type an S, followed by the hexadecimal address of the 
first memory location you wish to display. Type space. 


2 The data from the selected address is displayed, 
followed by a dash (-). 


Be To modify memory, type in the new data followed by a 
space or a carriage return. If you do not wish to 
modify the contents of that location, do not type any 
data in, but only type a space or carriage return. 


4. If a space was typed in step 3, the next memory 
location will be displayed as in step 2. Ifa 
carriage return was typed, operation will be returned 
to the CPU O.S. 


Example: The contents of the first four bytes of memory is 
OO Al CE FF. You wish to change it to 00 A3 CE ll. 
-SQOOOSpOOSp Al - A3Sp CE - Sp FF - 11cr 


User entries are unshaded. Display back is shaded. 


Error Conditions: 
Le If address is greater than 16 bits, or the data to be 


substituted is greater than 8 bits, only the last 4 
or 2 hex digits respectively are used. 


Example: The following sequence is equilvalent to the previous 
example: 


-SOABOOOOSp OO - Sp Al - BA3Sp CE - Sp FF - O11Cr 


2 Tf an invalid character is encountered, the CR Tube will 


immediately display '?(Cr) (1f).' and await the next 
command. 
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4.2.11 X COMMAND (EXAMINE AND MODIFY REGISTERS) 


The format of the X command is: 
X reg ident 


Reg ident is a Single character specifying a CPU register as 
follows: 


register 

register 

register 

register 

= register 

= Flag byte, displayed in the form as it is stored 
by the instruction PUSH PSW 

= H register 

= L register 

H and L registers combined (16 bits) 

Program counter (16 bits) 

= Stack pointer (16 bits) 


tHoQ Ww Pp 
| 
Hod Ww Pp 


NUS ee 
il 


Note: The format of the flag byte F is: 


A 
Sm “O- Cr 0: Pd C 


Sign bit State of carry bit 
Zero bit Always 1 

Always 0O State of parity bit 
Auxiliary carry bit Always 0O 


Description: The X command is used to display and/or modify 
CPU registers. It operates similar to the S command, as follows: 


1% Type an X, followed by the register identifier. 


2s The data from the selected register is displayed, 
followed by a dash (-). Four hexadecimal digits 
are displayed for M, P, and S; two hex digits for 
the other register identifiers. 


3: To modify the register, type in the new data followed 
by a space or a carriage return. If you do not wish 
to modify the register, type only the space or carriage 
return. 
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4. Tf a space was typed in step 3, the next register in al- 
phabetical order is displayed. If carriage return was 
typed, the X command is terminated. If a space is typed 
after register S has been displayed, the command is terminated, 
this being the last register identifier in the list. 


Example: The A, B, C, and D registers contain AAH, BBH, CCH, 
and DDH, respectively. You wish to change the B and C registers 
to OOH and FFh, respectively. 


XASp AA- Sp BB- OOSp CC- FFSp DD-Cr 


Note: Values set by the X-command will become the actual 
contents of the registers after execution of the next GO 
command. 


The values displayed by the X-command are the contents of 
the registers prior to the execution of the last breakpoint 
set by the GO command. These displayed values, however, 
will reflect any changes of register "contents" made by the 
execution of X-commands since this last breakpoint. 


Error Conditions: 


dg If the data to be substituted is greater than 16 
bits for registers M, P, S, or 8 bits for the other 
register identifiers, only the last 4 or 2 hex 
digits respectively are used. 


Zi If an invalid register identifier or character is 
encountered, the CR Tube will immediately display 
'?2(Cr) (L£).' and await the next command. 


4.2.12 E COMMAND (END FILE) 


The format of the E command is: 
E address 
Address is a valid 16 bit memory address. 


Description: The E command causes an end-of-file mark and 
sixty null characters to be written at the end of a hexa- 
decimal output file. The end of file mark is hexadecimal 
record of length 00. (See Appendix D). If address is O 

or absent, the L command which loads the file will return 
control to the CPU O.S. If address is non-zero, the L command 
will transfer control to that memory address immediately after 
loading the file. 
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4.2.13 W COMMAND (WRITE MEMORY) 


The format of the W command is: 
W low address; high address 
Low address is a valid 16 bit memory address. 


High address is a valid 16 bit memory address equal to or 
greater than low address. 


Description: The W command is used to output memory locations 
low address through high address to the system punch device 

in hexadecimal format. A series of W commands may be issued 

in order to punch various non-contiguous memory locations onto 

a continuous strip of tape. 

Any series of W commands should be terminated with an E command 
in order to punch a termination character, so that when the tape 


is read it will be handled properly. 


Example: If memory locations 1 through 3 contain 53F8EC, the 
command: .WOO0O1,0003 (Cr) 


produces: 
:0300010053F8ECC5 


(See Appendix D for an explanation of tape format.) 


Error Conditions: 
fs If low address or high address is greater than 16 
bits, only the last 4 hex digits of the argument 
will be used as the address. 
Example: The command: 
WABOO10,100 (Cr) 
is equivalent to the command: 
w0010,100 (Cr) 


2% If low address is greater than high address, only 
the one byte at low address will be written: 


ZS 


Example: The command: 


-W10,0(Cr) 
is equivalent to the command: 
-W10,10(Cr) 
3% Non-existent memory iS equivalent to a string of 


bytes all containing FF H. 


4. An invalid character in either address will cause 
the CR Tube to display '?(Cr) (l1f).' and await the 
next command. 


Example: If the user attempts to enter 3Z as low address, 
the following will be displayed: 


4.2.14 N COMMAND (NULL PUNCH) 


The N command consists only of the letter N followed by a 
carriage return and causes 60 null characters to be written 
on the punch device. 
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APPENDIX A 


~- INSTRUCTION SUMMARY -- 


This appendix provides a summary of 8080 assembly language 


instructions. 
A 


An 


ADDR 

Aux. carry 
Carry 

CODE 

DATA 
DATA16 

DST 

EXP 


INTE 


Abbreviations used are as follows: 
The accumulator (register A) 


Bit n of the accumulator contents, where n may have any value 
from 0 to 7 and O is the least significant (rightmost) bit. 


Any memory address 
The auxiliary carry bit 
The carry bit 
An operation code 
8 bits (one byte) of data 
16 bits (2 bytes) of data 
Destination register or memory byte 
A constant or mathematical expression 
The 8080 interrupt enable flip-flop 
Any instruction label 
A memory byte 
The parity bit. 
Program Counter 
The most significant 8 bits of the program counter 
The least significant 8 bits of the program counter 
Any register or memory byte 
A register pair. Legal register pair symbols are: 
B for registers B and C 
D for registers D and E 
H for registers H and L 


SP for the 16 bit stack pointer 
PSW for condition bits and register A 
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RP1 The first register of register pair RP 


RP 2 The second register of register pair RP 


sign The sign bit 

SP The 16-bit stack pointer register 

SRC Source register or memory byte 

Zero The zero bit 

XY The value obtained by concatenating the values X and Y 

[ ] An optional field enclosed by brackets 

( ) Contents of register or memory byte enclosed by parentheses 


Replace value on lefthand side of arrow with value on right- 


hand side of arrow 
CARRY BIT INSTRUCTIONS 
Format: 
[LABEL: ] CODE 
CODE DESCRIPTION 
STC (carry) <—— 1 Set carry 
CMC (carry) a Saar Complement carry 
| (carry) 


Condition bits affected: Carry 
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SINGLE REGISTER INSTRUCTIONS 


Format: 

[LABEL: ] INR REGM 

[LABEL: ] DCR REGM 

[LABEL: ] CMA 

[LABEL: ] DAA 
Code Description 
INR (REGM) (REGM) + 1 Increment register REGM | 
DCR (REGM) (REGM) - 1 Decrement register REGM 
CMA (A) (A) Complement accumulator 
DAA If (Aj-A3)> 9 or (aux. carry = l, Convert accumulator 

(A) (A) +6 contents to form 

Then if (A,-AJ)> 9 or (carry)= two decimal 

1 (A) = (A) + 6 *24 digits 


Condition bits affected: INR,DCR : Zero, Sign, parity 
CMA : None 
DAA >: Zero, Sign, parity, carry, aux. carry 


NOP INSTRUCTION 


Format: 
[LABEL: ] NOP 
Code Description 
NOP ‘Woo station nirie iei No operation 


Condition bits affected: None 
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DATA TRANSFER INSTRUCTIONS 


Format: 
[LABEL: ] MOV DST,SRC 
[LABEL: ] CODE RP 


NOTE: SRC and DST not both = M 


NOTE: RP = B or D 


Code Description 
MOV (DST) Gente (SRC) Load register DST from register SRC 
STAX ( (RP) )¢—————_ (A) Store accumulator at memory 
location referenced by the specified 
register pair 
LDAX (A) ¢<———— _((RP) ) Load accumulator from memory 


location refereced by the specified 
register pair 


Condition bits affected: None 


REGISTER OR MEMORY TO ACCUMULATOR INSTRUCTIONS — 


Format: 
[LABEL: ] CODE REGM 

Code Description 

ADD (A) ei —s (AA) + (REG) Add REGM to accumulator 

ADC (A) eS —s (AA): + (REGM) + (carry) Add REGM to accumulator 
with carry 

SUB (A) ¢ (A)-(REGM) | Subtract REGM from accumulator 

SBB (A) < (A)-(REGM)-(carry) Subtract REGM from accumulator 
with borrow 

ANA (A) ~—CS(AX*):sOAND $=(REGM) AND accumulator with REGM 

XRA (A): wee CA) OR. REGM) EXCLUSIVE-OR accumulator 


with REGM 
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Description 


(A) ¢— (A) OR (REGM) OR accumulator with REGM 


CMP Condition bits set by (A) -(REGM) 


Compare REGM with 
accumulator 


Condition bits affected: 


ADD, ADC, SUB, SBB: Carry, Sign, zero, parity, aux. carry 

ANA, XRA, ORA: Sign, zero, parity. Carry is zeroed. 

CMP: Carry, Sign, zero, parity, aux. carry. Zero set if (A)=(REGM) 
Carry reset if (A) < (REGM) 
Carry set if (A)> (REGM) 


ROTATE ACCUMULATOR INSTRUCTIONS 


Format: 


[LABEL: ] CODE 


RLC (Carry) i AG: Anyi AyrAg e599 Set carry =A7, rotate 
accumulator left 


RRC (carry) ¢ Ag, Ay, €- Ans /A7 e— "0 Set carry =Ap, rotate 
accumulator right 

RAL Roe <— An: (carry) ¢A7,Ao «—(carry) Rotate accumulator 
left through the carry 

RAR A,< AneL’ (carry) ¢—Ag/A4 (carry) Rotate accumulator 


right through carry 


Condition bits affected: Carry 


REGISTER PAIR INSTRUCTIONS 


Format: 
(LABEL: ] CODE1 RP 
[LABEL: ] CODE 2 


Note: For PUSH and POP, RP=B,D,H or PSW 
For DAD, INX, and DCX, RP=B,D,H, or SP 


eek 


Codel Description 


PUSH ((SP)-1) ¢ (RP1), ((SP)-2) ¢  (RP2), Save RP on the 
(SP) g. (oP) >2 stack 
RP=A saves accumulator 
and condition bits. 
POP (RP1), ((SP)+1), (RP2)e— ((SP)), Restore RP from 
(SP)g_ (SP) +2 the stack 
RP=A restores accumulator 
and condition bits. 


DAD (HL)g (HL) + (RP) Add RP to the 16-bit 
number in H and L. 

INX (RP) g_ (RP)+1 Increment RP by l 

DCX (RP) go CRP) <1 Decrement RP by l 

Code2 Description 

XCHG (H)e s(D), (L) ¢ » (E) Exchange the 16 bit 


number in H and L with 
that in D and E. 
XTHL (Lye 3((SP)), (H)e y( (SP) +1) Exchange the last 
values saved in the 
stack with H and L. 
SPHL (SP) e(H) 2:(4) Load stack pointer from 
H and L: 


Condition bits affected: 


PUSH, INX, DCX, XCHG, XTHL, SPHL: None 


POP : If RP=PSW, all condition bits are restored from the stack, otherwise 
none are affected. 
DAD : Carry 


IMMEDIATE INSTRUCTIONS 


Format: 
[LABEL: ] LX1 RP, DATA16 
-~Oor- 
[LABEL: ] MV 1 REGM, DATA 
-or- 
[LABEL: ] CODE REGM 


Note: RP=B,D,H, or SP 
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CODE DESCRIPTION 


LXI (RP)e~——. DATA 16 Move 16 bit immediate Data 
into RP 

MVI (REGM) ¢—_____DATA Move immediate DATA into REGM 

ADI (A)e__(A) + DATA Add immediate data to accumulator 

ACI (A). (A) + DATA + (carry) Add immediate data to accumulator 
with carry 

SUI (A)e—_-(A) - DATA Subtract immediate data from 
accumulator 

SBI (A)e—_-(A) - DATA - (carry) Subtract immediate data from 
accumulator with borrow 

ANI (A)e_-_(A) AND DATA - AND accumulator with immediate 
data 

XRI (A) ——— (A) XOR DATA EXCLUSIVE-OR accumulator with 
immediate data 

ORI (A)e——(A) OR DATA OR accumulator with immediate 
data 

CPI Condition bits set by (A)-DATA Compare immediate data with 
accumulator 


Condition bits affected: 


LXI, MVI: None 

ADI, ACI, SUI, SBI: Carry, Sign, zero, parity, aux. carry 

ANI, XRI, ORI: Zero, sign, parity. Carry is zeroed. 

CPI: Carry, Sign, zero, parity, aux. carry. Zero is set if (A)= DATA 
Carry reset if (A) < DATA 
Carry set if (A) > DATA 


DIRECT ADDRESSING INSTRUCTIONS 


Format: | 
[LABEL:] CODE ADDR 

CODE DESCRIPTION 

STA (ADDR) ¢ __(A) Store accumulator at location 
ADDR 

LDA (A) ¢——(ADDR) Load accumulator from location 
ADDR 

SHLD (ADDR) ¢—(L), (ADDR+1)¢ (3) Store L and H at ADDR and 
ADDR+1 

LHLD (L)e— (ADDR), (H)¢ (ADDR+1) Load L and H from ADDR and ADDR+1 


Condition bits affected: None 
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JUMP INSTRUCTIONS 


Format: 
[LABEL: ] PCHL 
[LABEL: ] CODE ADDR 
CODE 7 DESCRIPTION 
PCHL (PC) ~¢ (HL) Jump to location specified by 
register H and L 

JMP (PC) <—ADDR Jump to location ADDR 
JC If (carry) = 1, (PC)¢—— ADDR 

If (carry) = 0, (PCy en, (PC)tS Jump to ADDR if carry set 
JNC If (carry) = 0, (PC)¢, ADDR 

If (carry) = l, (PO) (PC)+3 Jump to ADDR if carry reset 
JZ If (zero) = 1, (PC) ¢ ADDR | 

If (zero) = O, (PC) < (PC)+3 Jump to ADDR of zero set 
JNZ If (zero) = 0, (PC) ¢ ADDR 

If (zero) = 1, (PC) é (PC) +3 Jump to ADDR if zero reset 
JP If (sign) = 0, (PC) <— ADDR : | 

If (sign) = 1, (PC) < (PC) +3 Jump to ADDR if plus 
JM If (sign) = 1, (PC) ~ ADDR 

If (sign) = 0, (PC) « (PC)+3 Jump to ADDR if minus 
JPE If (parity)= 1, (PC) ~ ADDR 

If (parity)= 0, (PC) — _(PC)+3 Jump to ADDR if parity even 
JPO If (parity)= 0, (PC) «ADDR 

If (parity)= 1, (PC) ~ (PC)+3 Jump to ADDR is parity: odd 


Condition bits affected: None 
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CALL INSTRUCTIONS 


Format: 
[LABEL: ] CODE ADDR 
CODE DESCRIPTION 
CALL ((SP)-L) a= (PCH)'5 ((SP)-2) 2. (PCL), (SP) e22(SP) 2, (PC) <«— ADDR 


call subroutine and push return 
address onto stack 


ce If (carry) = 1, ((SP)-1) e— (PCH), ((SP)-2) e— (PCL), (SP) e- (SP)+2, 
(PC) 22 ADDR 
Ef (earry)} > Oy: (PC) 2... KPC) a3 Call subroutine if carry set 
CNC If (carry) = 0, ((SP)-1 <— (PCH), ((SP)-2)e— (PCL), (SP) «— (SP)+2, 
(PC) ~— ADDR 
Ef Vearvy) Site PC) 22.2 (PC) +3 Call subroutine if carry reset 
CZ If (zero) = 1, ((SP)-1)- (PCH), ((SP)-2) e— (PCL), (SP) <— (SP)+2, 
(PC) ~~ ADDR 
Tf (Zero) = 20, ABC) ets (PCI 43 Call subroutine if zero set 
CNZ If (zero) = 0, ((SP)-1) <~ (PCH), ((SP)-2) e~— (PCL), (SP) e— (SP)+2, 
(PC) ~_ ADDR 
TE. (zero). =k. (Pe) e— (PC) +3 Call subroutine if zero reset 
CP If (sign) = 0, ((SP)-1) e—(PCH), ((SP)-2) e— (PCL), (SP) e— (SP)+2, 
(PC) <— ADDR | 
If (S29gn): “= 1. (PC) a. (PC)+3 Call subroutine if sign plus 
CM If (sign) = 1, ((SP)-1)e— (PCH), ((SP)-2) <— (PCL), (SP) ¢—(SP)+2, 
(PC) ~ ADDR 
Tf (sign). =O, (PC) zs 4PC)4+3 Call subroutine if sign minus 
CPE If (parity)= 1, ((SP)-1) —— (PCH), ((SP)-2) <— (PCL), (SP) <—(SP)+2, 
(PC) e ADDR 
LE: (parity) = 0; (PC) 22. (PC) +3 Call subroutine if parity even 
CPO If (parity)= 0, ((SP)-1) <— (PCH), ((SP)-2) <— (PCL), (SP) e— (SP)+2, 
(PC) <— ADDR 
Te (parity)= 1 (PC) (Pees Call subroutine if parity odd 


Condition bits affected: None 
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RETURN INSTRUCTIONS 


Format: 


[LABEL: ] CODE 


DESCRIPTION 


(PCL) e- ((SP)), (PCH) <— ((SP)+1);, (SP) <«—(SP)+2 
Return from subroutine 


If (carry) = 1, (PCH) <— ((SP)), (PCH) <— ((SP)+1), (SP) <— (SP)+2 
If (carry) (PC) gen (PC) TS: . Return if carry set 


Tf (Garry) (PCL) e— ((SP)), (PCH) <— ((SP)+1), (SP) e— (SP)+2 
If (carry) (PC) e  (PC)+3 Return if carry reset 


If (zero) L, (PCL) <— ((SP)), (PCH) <— ((SP)+1), (SP) ¢— (SP)+2 
If (zero) O07 (PC) 2. (PE)+3 Return if zero set 


(zero) , (PCL) es ((SP)), (PCH) —. ((SP)+1), (SP) <— (SP )2 
(zero) = (PC) <— (PC)+3 Return if zero set 


(sign) = (PCL) «<— ((SP)), (PCH) <— ((SP)+1), (SP) <— (SP)+2 
(Sign) = (Pc) —— (PC) +3 Return if ininus 


(Sign) = (PCL) <== ( (SP). % (PCH) 2 ((SP)+l) > (SP) 2. (SP) +2 
(sign) = (PC) e— (PC) +3 Return if plus 


(parity)=1, (PCL) ¢-((SP)), (PCH) <— ((SP)+1), (SP) ~<—(SP)+2 


(parity)=0, (PC) «— (PC) __ (PC)+3 Return if parity even 


(parity)=0;,. (ich): 2. C(SP)) > (PCH) <= C(SP)41)@ (SP). < (SP) +2 
(parity)=1, (PC) <~— (PC)+3 Return if parity odd 


Condition bits affected: None 


RST INSTRUCTION 


Format: 
[LABEL: ] RST EXP 


Note: O EXP 7 


CODE DESCRIPTION 


RST ((SP)-1) <— (PCH), ((SP)-2) #e (PCL), (SP) e- (SP)+2 
(PC) <— OOOOO00000EXPOO0B Call subroutine at address 
specified by EXP 


Condition bits affected: None 
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INTERRUPT FLIP FLOP INSTRUCTIONS 


Format: 
[LABEL: ] CODE 
CODE DESCRIPTION 
EL COUN TES). eeeecces, Enable the interrupt system 
DI CINDER) gee a.'0 Disable the interrupt system 


Condition bits affected: None 


-INPUT/OUTPUT INSTRUCTIONS 


Format: 2 
[LABEL: ] CODE EXP 
CODE DESCRIPTION 
IN (A) ee input device Read a byte from device EXP into 
the accumulator 
OUT output device <—— (A) send the accumulator contents to 
device EXP 
Condition bits affected: None 
HLT INSTRUCTION 
Format: 
[LABEL: ] HLT 
CODE DESCRIPTION 
HLT =| rr rr eee eer Instruction execution halts until 


an interrupt occurs. 


Condition bits affected: None 


PSEUDO - INSTRUCTIONS 


ORG PSEUDO - INSTRUCTION 


Format: 
ORG EXP 
ORG LOCATION COUNTER < EXP Set Assembler location 
counter to EXP © 
EQU PSEUDO - INSTRUCTION 
Format: 
NAME EQU EXP 
EQU NAME <——_________ EXP Assign the value EXP 
to the symbol NAME 
END PSEUDO - INSTRUCTION 
Format: 
END 
END End the assembly. 
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APPENDIX B 


--INSTRUCTION EXECUTION TIMES AND BIT PATTERNS-- 


This appendix summarizes the bit patterns and number of time states 
associated with every 8080 CPU instruction. 


When using this summary, note the following symbology: 


1) DDD represents a destination register. SSS represents a 
source register. Both DDD and SSS are interpreted as 
follows: 

DDD “OF -SSS Interpretation 

OOO Register B 

OO1 Register C 

O10 Register D 

O11 Register E 

100 Register H 

101 Register L 

110 | A memory register 
fd Eo The accumulator 

2) Instruction execution time equals number of time periods 


multiplied by the duration of a time period. 

A time period may vary from 480 nanosecs to 2 microsec. 

When two numbers of time periods are shown (eg. 5/11), it 
means that the smaller number of time periods will be required 


if a condition is not met, and the larger number of time periods 
will be required if the condition is met. 
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CALL 
CC 


11/17 


CNC 
CZ 


LLL? 


11/17 


CNZ 
}CP 


yy ly 
Pay LT 


CM 
CPE 
CPO 


LILA LT 
11/17 


10 
Bf ALL 


RET 


5/11 


5/11 


5/11 


5/11 


5/11 


5/11 


D/A 


11 
10 
10 


OUT 


10 — 
10 
10 
10 


LXI B 


LXI D 


LXI 4H 


LXI SP 


11 


PUSH B 


11 


PUSH D 


11 


PUSH H 


il 
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PUSH A 


POP B 


POP D 


10 
10 
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[POP H 


POP A 
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LDA 
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|XCHG 
XTHL 
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SPHL 
PCHL 


10 


DAD B 


10 


DAD D 


10 
10 


DAD H 


DAD SP 


oTAX B 


STAX D 


LDAX B 


LDAS D 


INX B 


INX D 
INX H 


INX SP 
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Number of Time Periods 
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DCR A 
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DCR M 
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SUB 
OBB 
NDA 


XRA 
ORA 


CMP 


dy 


ADD M 


ADC 


SUB M 


SBB M 
NDA M 


ORA 
CMP 
ADI 
ACI 


SUI 
SBI 
NDI 


XRI 
ORI 
CPI 


RLC 


RRC 


RAL 


RAR 
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10 
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JMP 
JC 


JNC 
JZ 
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10 


JNZ 
JP 


JM 
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IPO 
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APPENDIX C 


HEXADECIMAL PROGRAM TAPE FORMAT 


The hexadecimal tape format used by the Intecolor® 8001 system isa 
modified memory image, blocked into discrete records. Each record 
contains record length, record type, memory address, and checksum 

information in addition to data. A frame by frame description 

is as follows: 


Frame 0O Record Mark, Signals the start of 
a record. The ASCII character 
colon (":" HEX 3A) is used as the 


record mark. 


Frames 1,2 Record Length. Two ASCII characters 
(0O-9,A-F) representing a hexadecimal number 
in the range 0 to 'FF'H (O to 255). 
This is the count of actual data 
bytes in the record type or check- 
sum. A record length of O indicates 
end of file. 


Frames 3 to 6 Load Address. Four ASCII characters 
that represent the initial memory 
location where the data following 
will be loaded. The first data byte 
is stored in the location pointed 
to by the load address, succeeding 
data bytes are loaded into 
ascending addresses. 


Frames 7,8 Record Type. Two ASCII characters. 
Currently all records are type O, 
this field is reserved for future 


expansion. 
Frames 9 to 9+2* (Record Data. Each 8 bit memory word is 
Length) - l represented by two frames containing 


the ASCII characters (0 to 9, A to F) 
to represent a hexadecimal value 0 
tO “HEH CO £0. 255).; 
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Frames 9+2* (Record Length) to 
Y+2* (Record Length) +1 


Checksum. The checksum is the 
negative of the sum of all 8 bit 
bytes in the record since the 
record mark (":") evaluated 
modulus 256. That is, if you 
add together all the 8 bit bytes, 
ignoring all carries out of an 
8-bit sum, then add the checksum, 
the result is zero. 


Example: If memory locations 1 through 3 contain 53F8EC, the format 
of the hex file produced when these locations are punched is: 


:O3000L0053F8ECC5 


Note: This format is also known as the Intel format. 
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= Deemer 
oo 2 Bartlett Associates, Eric. Miemorandum 
= nares 150 Speen Street 

m4 ; { > Framingham, Mass. 01701 


(617) 879-7530 
In Reply Refer To: 


To: Dave Deans 

Subject; Greg Whitten's Disassanbler Prom: j346, Snrena 
Date: June 16, 1977 

Copies: AJjl Hands Ref: 


NO documentation exists except that which 
Greg wrote and forwarded to Charles Mucnch. I believe you or John DeWolf were 
concerned, last week, that it was unable to decode "push" statanents. With the 
corrections listed below, it quite properly handles than. The missing code at 
or about line 440: 


The disassanbler by Gree is ingenious. 
ra | > 


Pee ee ae 
ee re oe 
430 OS=ID$(D3)+R2$(RP) : Return ~~? 
440 OSH" INR 3444 "+R$(X1): Return 
450 O$="DCR 44444 "+R5(X1) Return Baa Te 
AGO O$="MVI A4A44 "4RS(XL)#',":Go to 800 


*4 Denotes Space 
Greg has verbally explained how to use the disassenbler. 


He explains that the first set of statements requiring response are Compucolor - 
Display or list. Only the first letter of each, or any question; need be typed. 
A Conpucolor (we chould change this variable nane to something clse) response or 
C sets the output format to 48 lines. Display is 24 lines and list is 66 for a 
high speed printer. 


The second interactive response for numbering system is self-explanatory. Greg 
recommends using hex — address must use four digits. Fill in with Icading vero's, 
if not four digits. A decimal systan is correct if, and only if, we use a decimal 
for the address. An '"'O' assumes octal. 


Byte; Character or Display dump yields: 


B -— dump in hex 

C — dump in character format 

D - Display and symbol generation. 

The add, character, make and no, symbol interaction Greg considers is the only 
confusing issue. The symbol table is the same idea as any symbol table from 
a compiler, i.e. listing of each variable's address in manory. 


Dave ans 
June 16, 1977 
Page 2 


The response: 


ZX 
| 


No table (the casiest) 

M —- Make a table 

Add more symbols manually on second pass. 
Clear previous symbols before making table. 


OQ 
4 


Responses may be "ORed" for finesse c.g. AM means add and make a table, 
CM - clear and make, ete. This routine should be worth $100 to a customer’? 
It outputs in standard Intel 8OSO code. 


tovards, 


] 
Y 
) 
: 1 
: 4 Ji fe rat 10, 


C, Joseph M. Sanrana 


JMS : kmg 


3800 


Lh 
co 
_ 
HA ON ON FP HO WwW AO WwW 


3820 


SW BH W bP 


OO 
ee) 
Uo 
© 


-> O ON DMN FW DY FF 


F6 
26. 


2 DE 


7E 


BARTLETT ASSOCIATES INC. 


Dumb Terminal Emulation - No Parity-No Graphics 


Cee 
ie 06 


Cz. 


1B 
4B 
OE 
1B 


(Oe 


33 
OF 
OC 
1B 
46 
EE 


09 


FULL DUPLEX SOFTWARE 


01 
OA CIE of) 
B8 
11 


OL 


B38 


OL 
B8 


start: 


loop: 


over 


table 


LX1 H, TABLE 
CALL MESSX INITIALIZE OR TERMINAL 
CALL KETST 

JZ OVER "'Z'" =) NO KBD CHAR 

IND INTAD CLEAR 

CALL RDKEY GETKBD CHAR 

MOV C,A Send to RS-232 via PUNCH 
CALL PO 

IND STBFA GET I/O STATUS 

ANI TTYDA IF NO RCV CHAR 

JZ LOOP THEN LOOP 

IND RXBFA ELSE GET IT 

ORI 80H REMOVE PARITY 

MVI H, CHAS 

MOV L,A 

MOV A,M 


CALL CO 


JMD: - OOP 


DB 1B ESC 
DB 4B K SCROLL 
DB OE CTRL N 

DB 1B ESC 

DB 52 B 

DB 33 3 BAUD RATE 
DB OF CTRL-O 

DB OC: CTRLeL 

DB 1B ESC 

DB 46 F  FDX 

DB EF TERM 


B800 


BBl1 


B82 


Mm OO CON NW FP HO PN DW KE YH AQ wo Dn Ww 


ve) 
CO 
eS) 
© 


> 0O ON DU KR WD BB 


26 


Dumb Terminal Emulation - No parity-no Graphics 


E> 


09 
06 


Ll 


O1 


B8 


B8 
00 


Ol 
B8 


BARTLETT ASSOCIATES INC. 


HALF DUPLEX SOFTWARE 


start: 


loop: 


OVeET: 


skip: 


table: 


LXI 
Call 
Call 
IZ 
IN 
CALL 
MOV 
CALL 
POP 


INP 
ANJ 


H, 


Table 

MEOSx 

KETST 

OVER 

INTAD 

RDKEY 

G, A, PUSH PSW 
PO 

PSW 

SKIP 

STBFP 

TTY DA 

LOOP 

RXBFP 

80H 

H, TRANS SHR 8 
ee 

A,M 

LO 

LOOP 


ESC 
K SCROLL 
CTRL-N A7 ON 
ESC 

R 

4 1200 BAUD 
CTRL-O A7 OFF 
CTRL-L CLR SCRN 
ESC 

H HDX 
TERMINATOR 


roy a: “Char 


CRT Char 


B8 80-00 NULL NULL 
1-00 Protect Protect 
2-00 Plot Mode NULL 
3-03 CURSOR X,Y CURSOR X,Y 
4-00 FREE FREE 
5-00 FREE FREE 
6-06 CCI CCI 
7-07 BELL BELL 
3-08 HOME HOME 
9-09 TAB TAB 
A-OA LINE FEED LINE FEED 
B-O8 ERASE LINE ERASE LINE 
C-OC ERASE PAGE ERASE PAGE 
D-OD CR CR 
E-OE A7 ON A7 ON 
F-OF BLINK/A7 OFF BLINK / A7 OFF 
B890-00 BLACK BLACK 
L-11l RED RED 
2-12 GREEN GREEN 
3-13 YELLOW YELLOW 
4-14 BLUE BLUE 
5-15 MAGENTA MAGENTA 
6-16 CYAN CYAN 
7-17 WHITE WHITE 
8-18 TRANSMIT TRANSMIT 
9-19 CURSOR RIGHT CURSOR RIGHT 
A-1A CURSOR LEFT CURSOR LEFT 
B-1B ESC ESC 
C-1LC CURSOR UP CURSOR UP 
D-1LD F6 ON/FLAG OFF F6 ON/FLAG OFF 
R-1E BG ON/FLAG ON BG ON/FLAG ON 
F-1F BLINK ON. BLINK ON 
1 SHIFT 1 to / 
B8A0-20 SPACE SPACE 
1-21 ! ! 
Val? im | tet 
3-23 if iF 
4-24 S S 
5-25 ve ls 
6-26 & & 
7-2/7 
8-28 ( ( 
9-29 ) ) 
A-2A * * 
B-2B +- +- 
~ C=2C 
D-2D - - 
E-2E : 


F-2F / / 


rev'd Char CRT Char 


B8B0-30 


0 0 
1-31 L 1 
2-32 2 Z 
3-33 3 2 
4-34 4 4 
5-35 5 5 
6-36 6 6 
7-37 7 / 
8-38 8 8 
9-39 9 9 
A-3A : 
B-3B ’ ’ 
C-3C 
D-30 = = 
E-3E 


F-3F ? | ts 


BSCO-49 


hiatal 
Deady? 
3-43 
Luwslis 
5-45 
6-46 
7-47 
8-43 
9-49 
A-GA 
B-4B 
C-46 
D-4D 
E-4E 
F-4F 


B8DO-50 


1-51 
2-52 
3259 
4-54 
5-2) 
6-56 
{27 
8-58 
9259 
A-5A 
B-5B 
C-5C 
D-SD 
E-5E 
Feor 


B8EO-60 


1-61 
2-62 
3-63 
4-64 
5-65 
6-66 
7-67 
8-68 
9-69 
A-6A 
B-6B 
C-6C 
. D-6D 
E-6E 
F-6F 


PS uUL-TNK MES CGHNDWO'W 


C) 'AJ 
ae 


OSB SCAG SOMO Ow bia 


OD Sw wee O'GQ ho a OD 


Wo 


a a, 
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TOL RNS KS 


se FUR wood 


HO LRPON Sw 


PAGE 10 


DOS TO FCS DISKETTE CONVIERSION 


 caeaemeamceetietiaeanatientieae setiaiatbesinieaen Cernitaameestatieinnese tienes smenendiatirne eas enim cataatinte campeencae anemones raat an ean ae edie nee a EE ORO ne TE eS eta tate) 


€ 


Type CPU Reset, ESCAPE OD and then FCS will be 
printed on the screen. | 


Now place the’ diskette included jn the conversion kit 
in the disk drive and close the door. 


Type RUN CONVRT (Return) and then the unit will 
ask you whal drive nos, tne DOs diskette 41s.m. Replace 
the diskette now in the drive with a DOS diskette to be 
eonverted Te. Gs, 


Now type @ for left hand or single drive and 1 for the 
Might Tamed arrive, 


The Conversion will take about 5 seconds for most DOS 
diskettes and is permanent. The converted diskcttes 
will now work on the ''CS system and not the DOS 

Sy Seein. 


kee? 


te Om: 
f t 


FILE CONTROL SYSTEM 
gS PSE aes OSES ea alae 


When you receive your Intecolor System, be sure your unit is working cor- 
rectly before connecting any other I/O device, except the keyboard. 


ee 
1. Turn the Intecolor power off, 


Le Plug the ribbon cable from the disk unit into the RS-232 type connector 
labeled “FLOPPY DISK". NEVER CONNECT Tile RIBBON CABLE 


ee a ne a aries ere eae te eee ae nnaPannmn eR Ln a heey neem eee imge ees ms Anettenninp aD 


INTO ANY OTHER RS-232 TYPE CONNECTOR OR DAMAGE TO THE. 
DISK UNIT MAY RESULT. 


aK Plug the DISK power cord in an AC outlet. 
4, Now turn on the Intecolor CRT power and the system is now ready. 
BEGINNING DISK OPERATING INSTRUCTIONS 


. Insert the labeled diskette into the disk drive with the label up and in 
the lower right-hand corner, and close the gate. 


) NA PR ERR By AR ne AR enn DORR LL CrOGET RE wr | 


DISKET TE- OC 


[I 


EN OOK Cabal / Nee NRE MIN ANLEN £8 peattatnacemreenettannst 


, ee 


ae Enter(CPU RESET) Esq, D and the message prompt FCS > will appear. 
Then type either DIR (Return) or DIR}: (tar) for the second drive and 
a listing of programs available on that diskette will be displayed followed 
. by The prompt messave PCS? . Once in the Pile Control System, DIK 
_ should be used for listing the directory. To change drives, type DEVO: 
(Return) for the left-hand, DEVI: (Return) for the right-hand. To change 
device type enter DEV FD9; (8'' FLOPPY DISK) or DEV MD@: (MINI DISK) 
or DEV FT¢@: (FLOPPY TAPE). 
3. To loada particular BASIC program, type (ESC) then W and (Return). 
(ESC) then D and following the FCS> prompt message type DIR mee 
Type (ESC then E and LOAD? "PROGRAM NAME" then (Return). 


(See example 1) 


XN 


1SC146-1077 
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4, If something other than READY comes back, then type LOAD? ''PROGRAM 

NAME" and(Return again. If the program still does not work, select 
another program and try again, If it still doesn't function properly, check 
with the FCS Commands and DISK BASIC MANUAL, 


EXAMPLE 1: TO LOAD A BASIC 8001 PROGRAM 


You type(ESC E the system prints READY 

You type LOAD?'"PROGRAM NAME" (Return) the 
system prints READY 

You type RUN, (Return) and the loaded program will 


execute 


tity Ly ills sg 


Padi 3 


HOW TO SAVE A DISPLAY 


ae oceeeiaeietniamia diemeeanen nenahamsibnaaetaaminanie ene eamcatannen enammntenaree eto tan Caeatet eran aa enretusnn atone aaenateetnent deme corer cae’ naeanaaehantane eed 


Enter BASIC 8001 and type the following program: 


$PLOT27:PLOT4: PRINT"'SAVE@:SCREEN. DIS 8690-9DFF':END (eturn) 
NOTE: Screen can be any file name and .DIS is optional as is y 
for drive number. 
Now type PLOT2:PLOT 255 (Return). This will put the display in the 
correct location so that the display memory location is at the top left 


corner of screen, 


Put the display on the screen to be saved. You can use the cursor 
control keys to correct all errors in the display. 


Now position the cursor so as to have about 4 lines by 5 characters each 
on the left area of the screen clear. Select Foreground and Background 
colors the same as the display color in this area. Type(ESC) E and 

then type RUN: and then Background, Black, Foreground, Red and then 


(Reiura). 


NOTE: You will not be able to see the characters you type in. 


OO ce ne a 


After the display has been SAVED then READY will appear. 


Now that the display is saved on diskette you may erase the page. To 
recall the display to the screen, type (ESC) D and after the prompt message 
FCS> appears, youtype: LOAD§:SCREEN.DIS and the whole display 
will be loaded onto the screen. 


NOE: ithe screen is to be generated from BASIC 8001 program, then 
the pr process could be simplified by just including the BASIC 8001 state- 
ments at the end of that program, as in Step 1 above. 
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Le 


HOW TO FORMAT AND INITIALIZE A DISKETTE 


FORMAT 


en ee 


1. Put in the Diskette with the MDF RMT program on it and close the gate. 


2. HitSC) D and Type DIR (Return), a listing of all files will be displayed. 


3. Type RUN MDFRMT (Return). The peoaeee FLOPPY DISK FORMATTER 
should be returned by the unit. SEPT 
NOTE: For 8" Disk System type RUN (BE DERMT (Return 
4. Now take out the diskette that MDF RMT (or Bb peer) was loaded from. 
Put in the diskette that is to be checked or formatted and close the 


pate. (ete...) 


1) A READ CHECK will allow you to check a diskette that already has 
programs on it to see if the diskette has any unreadable blocks, 


2) FORMATTING a diskette will prepare it to accept programs. 


f CAUTION: Formatting a diskette will completely wipe out any infor-' 
mation previously stored on the diskette. 


To do a READ CHECK type R and then the drive number (9,1). The printout 
on the screen is decoded (see below) into data and address errors. Unless 
the last three letters are RED then the error is a soft error, but if there 
are a lot of these Blue, Yellow, or Green errors you should try to get 
another copy of your source program on amore error-free diskette. To 
FORMAT a diskette, insert a blank diskette and type F and the drive number 
(6,1), and a colorful pattern will be displayed on the screen. After the disk 
has been formatted it will automatically do a READ CHECK as described above, 
The computer will return to the DISK FORMATTER Program which allows 


you to FORMAT many diskettes in a row. 


FORMAT ERROR DECODING 


T . 

O Track No. 0 to 22 for MD or 0 to 4C for FD (Values are in Hex) 

7 

S : 

0 Sector No. 0 to 11 for MD or 0 to 2D for FD (Values are in. Hex) 

(D - Data Error A -Address Error ; ke 

(O - Read Error l1 -Write Error 1] - Read & Write Error 


(8 | 0 8 


biwo, CUNT, . : PAGE 5 


NOTE: The color of these three characters tells how many Read/Write 
errors ina row the computer found. l=WHITE, 2=CYAN...8=RED 
‘RED is not acceptable below track #20 HEX for MD or #40 HEX 
for FD ’ 


INITIALIZE 


TypeSc )D the system will print FCS >. 
Then you type: INI MD0O: (10 letter name) (optional no. directory blocks). 
The diskette is now formatted, initialized and ready for storage of programs or 


data, 


EA ean mah esgninn Oi 


default to 24H blocks for the Directory. 
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SUMMARY OF THE. 
FILE CONTROL SYSTEM COMMANDS. 


The following definitions will be used to describe the FCS commands: 
( ) Means manditory part 


[ ]} Means optional part and if not specified, will result in the default 
type. 


(Device name:) = [Device type J [Number J] (:) 


Device types are MD, FT, and FD for Mini-Disk, Floppy Tape and 
8'' Floppy Disk and number is either 0 or 1. | 


(Memory spec) = (Load address) (Byte count) or (-End address) 
all memory addresses are in HEX format. 


(File spec) = (File name) '.Type| [ Version| 


File name is any 6 characters. Type can be any three charcters and 
PRG is detault types. Version 1s: 0 to PP HEX number, 


NOTE: After a default device type has been selected only the number of the 
device is required, 


COPY or COP = [ Device Name: ] (File Spec) TO (Device Name:) 
(File Spec) will copy one file from one disk drive 
drive to another. 


DUPLICATE or DUP (Device name:) TO (Device name:) - will dup- 
licate all the files on the original diskette onto 


another diskette. DPephcetes dickuane alSe 


DUPLICATE ALL Same as DUP, but duplicate complete disk not 


or DUA just the liles areas. 
DEVICE or DEL [Device name: ] (File Spec) - all options -re- 


’ quired. Allows the user to delete any file in 
. one step. 


DIRECTORY or DIR: | [Device name:] lists directory of the default -. 
or specified device. 


EAIT "FCS" ESCAPE and ESCAPE again 


ttna, GCOiva, PAGE 7 


INITIALIZE or INI (Device Hames) (Volume name) No. of DIR 
| BLOCKS No. of directory blocks will default to 
: a normally adequate no.; NOTE: Device name 
| 7 ; 2 requires all options. 
) (AN \ lon 2 : This ww ll Wine ot (ll BroghownG Lorn The Diskette 
SAVE or SAV [Device name:] (File Spec) (Memory Spec) 
| Start address Acutal address Start 
Address defaults to LOAD address and actual 
address defaults to load address. 


LOAD or LOA : [Device name: ] (File spec) [Load address] 
RUN [Device name:] (File spec) 
RENAME or REN [Device n me:] (File spec) TO (File spec)- 


allows the user to rename any file to any 
other name. 


READ or REA [Device name: 1] (Start block no.) (Memory 
spec) - will read anywhere on the diskette 
starting at any block and ending where speci- 
fied, without regard to program boundaries. 


WRITE or WRI [Device name: ] (Start block no. ) 
_ (Memory spec) 
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HOW TO USE THE 
FILE CONTROL: OYOLE M [ COMMANDS 


COPY or COP - allows the user to copy one file from one diskette to another 
if you have a dual drive system, or a system with two different 
types of devices. 


EX AMP ILE: Type(ESC )D and when the system responds with 
FCS Athen type in COP$:TEST., PRG TO 1:ABC (Return) 
This will copy the latest version of TEST. PRG on device @ 


to file name ABC.PRG on device 1 


DUPLICATE or DUP ~- allows all the files on one diskette to be EReuesc Tce 
£O another diskette, 


nn tnt pct arte eNO oe AN 


FCS> hea type in Esc)" TO 1: fRet turn) or 
DUP MDI: TO MD@: 


DEVICE or DEV - allows the user to change the default device or drive. 


JV bles. pean SC) D and when the system responds with 
ECS > then type in DEV 1: will change the default device to 

a. Drive 1 (right hand) 

DEV MD@: will change the default device to 


mini-disk drive ¢@ (left hand) — 


DELETE or DEL - allows you to delete any file on the diskette. 


EXAMPLE: Type in(eSC) D and when the system responds with 
FCS 7 then type in 


DEL TEST.PRG;1 @eturn) © NOTE: all file informa- 
or DELI1:TEST.DAT;2 (Return) | tion is needed to delete a 
or DEL MD1:NAME. ARY;1 (Return) file, ‘This is the file pro- 


tection that is provided to 
protect the diskette. 


DIRECTORY or DIR - lists all the programs on the diskette on any drive no. (9, 1) 
BEAAMPLE: Type in(ESC )D and when the system responds with 
FCS FCS? then type in DIR for default drive 
DIRG: Return) ; for left hand default drive or 
DIR MD1: Q@eturn for right hand mini-disk drive 


PAGO Y 


INITIALIZE or INI- allows the user to name a diskette a 10 letter name and also 


SAVE or SAV - 


or 
or 


name an optional number of directory blocks allotted. 


EXAMPLE: Type in(ESC) D and when the system responds with 


FCS > then type in INI MD¢#:SAMPLENAME (Return 


optional 
Mini Disk defaults to 9 blocks | 
Floppy tape defaults to storage in K/8 blocks (8K=1 block) 
8'' single sided disk to 24H blocks 


8'' double sided disk to ° 48H blocks 


allows the user to save any type of data, array, or program file 


on diskette. 


BAAMPIIES Type in(&SO D and when the system responds with 
FCS > then type in SAVE @:TEST.ASM;%#1 LOAD address-End 


address (Return) 


SAVE TEST LOAD address Byte count Hex Return 
SAVE MD1:TEST.DAT;¢1 A@9$@ - BFFF Start Address, Actual 


ASM - Assembly source program 
PRG - Object code program 
DAT - Data File 


NOTE: If the same File Name is reused then the version number 
will be 1 higher than already on disk by that same name 


Both the (ASM, DAT) and (VR#01) are optional but help define the 


file better. 


To SAVE and LOAD programs from BASIC it will be necessary 


to go into BASIC first then follow the instructions in the DISK 
BASIC 8001 Manual. 


LOAD or LOA - allows the user to load any type file into any RAM memory 


or 
or 


location he may wish to. This-indicates that you may bring a 
display to the screen which is correct. LOAD command uses 
the same guide lines as the SAVE command. 


EXAMPLE: Type(ESC)D and when the system responds with 
FCS > then type in 

LOAL:TEST,PRG3L (Test must be a PRG type) 
LOA:DISPLA.DAT;]1 (DAT -Indicates data file) 


LOA MD@:DISPLA.DIS;1 8900 (899@- Indicates where it will 


- load) 
NOTE: If version number is not specified then the highest 
version will be used. 
To load BASIC programs see section handed "SAVE/LOAD" in 


INI MD1:TESTDISKO1 10 (Return) the 10 is 


A 
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RUN - allows the user to load an object code program and then start ex- 
ecution of the program all in the same command if there is a start 


address other than @ in the directory 


BXAAMP ii: Type (ESC C )D and when the system saeseate with FCS> 


then type in RUN CHESS ¢- (CHESS must be a PRG file) 
or RUN1:CHE,. ASM;32 (If it is an ASM file it must be 
specified) | 


RENAME or REN - allows the user, in one step, to change the File Name, 
File Type,and the Version No. separately or collectively without 
changing ‘he information stored in the Pavera | 


EXAMPLE: ‘Type (ESC) D and when the system responds with «CS> 
then type-in RIN TEST. PRG31 TO PEST l,23oM5Z2 
or RENO: TEST.ASM;2 TO Tisolyi 


READ or REA - allows retrieval of information on any part of the diskette 
without regard to the directory or program boundaries. 


D and when the system responds with FCS> 


ie 
ee type i: in REA — 8000 - 9E00 (will bring info. to screen) 
or REA 0:100 .8000° 1EOO £(will do the same as above) 


WRITE or WRI - allows information to be written anywhere on the diskette 
without regard to the directory or previous program boundaries. 


EXAMPLE: Type(ESC) D and when the system responds with FCS2. 
then type in WRI 0:220 8000 - 9F00 ‘(will save\hats on screen) 
or WRI 0:220 8000 1E00 (will de the same as above) 


FILE CONTROL SYSTEMS 
ERROR STATEMENTS 


EIVC - INVALID COMMAND 

ECFB - 

EMVN ~ MISSING VOLUME NAME 
ESYN - SYNTAX ERROR 

EDIR - DIRECTORY ERROR 

EIVP - INVALID PARAMETER(S) 
ENVE - NO VOLUME ENTRY IN DIRECTORY 
EMEFN - MISSING FILE NAME 

EMDV - MISSING DEVICE’ NAME 
EMVR - MISSING VERSION 

SIVD - INVALID DEVICE 

ENSA - NO START ADDRESS 

EDFN - DUPLICATE FILE NAME 
nvo¥. VERSION NUMBER OVERFLOW 
EFNF - FILE NOT FOUND 

EDRF = DIRECTORY FULL 

EFRD - FILE READ ERROR 

EFWR - FILE WRITE ERROR 

EWSZ - FILE TOO LARGE FOR WRITE 
ERSZ - FILE TOO LARGE FOR READ 
EDEL - DELETE ERROR 
EDUP - ERROR DURING DUPLICATE 
ESIZ - DEVICE SIZES NOT SAME 


ECOP - ERROR DURING COPY 


ElvT - tkhvAurd 


a £hX sy 


dd 


THINGS TO BE NOTED 


Always be sure to have a diskette in the disk drive and the gate closed before 
hitting(ESC) D, DIR (Return) or any other FCS command. 


If the disk drive fails to stop running after typing the directory, or after 
execution of any other FCS command, type ESC} Dor (CPU RESET). 


When a disk drive does not function and an error statement appears across 


the screen such as: 

FCS Error - EIVC - INVALID COMMAND 

Please check your list of error statements of Page if of this manual. 
Each mini-diskette has 276 Hex Blocks. 

Each 8'' Diskettes has 906 Hex Blocks. 

Each block has 80 Hex bytes. (128 decimal) 


All File Control System commands involving the alphabet letters should be 
separated by spaces or commas. 


“Any control code other than contro{K) (ERASE line) will terminate the command 


typed in, : 
Any ESC command terminates the FCS system. (Normally use ESC, ESC to 
go to visible cursor mode. ) 


NOTE: The host computer can generate all of the FCS commands over the 


nm rte eee A aE 


RS 232 channel. But the command will not appear on the screen, nor will 
the FCS % prompt, In fact this is how DISK BASIC 8001 uses the system. 


PCS DIR (RETURN) 


netribute 
byte 


Y3 


Not Free 


but in use 


p3 


pr 


denotes 
free space 


3 


DIRECTORY 


NAME 


Program 
Name 


PRINTL 


Name of 
Program 
any 6 
alpha 
numeric 
char. 


MDF RMT 


Same as 
above 


ABC 123 


same as 
above 


MDZ: 
(DEVICE TYPE 
AND DRIVE NO,) 


SAMPLENAME 


(10 LETTERS 


FOR NAME) 
TYPE VR 
File Version 
type 
» BAS 761 
Type of Version 
file BASIC No. of Prog. 
_ Program FCS auto= 
matically 
Lnerements 
the VR 
NO, 
«PRG 72 
Assembly 2nd 
language Version. 
program 
file type 
eDAT ;O1 
Data file 


(Free space) 


Version 


6 


(NO, DIRECTORY 
‘BLOCKS) 
SBLK «SIZE 
Start Size of 
Block Program 
P~13 ~Yo4 
Starting No. of 
Block SOH Byte 
where Blocks 
program | this 
Starts on . Program 
diskette uses 
677 G22O 
Same as 6 (80H 
above Byte 
Block) 
long 
Q7D PABL 
Same as Size of 
above Data 
Q12E Hex QO148 Hex 
Total No. Total No. 
of Bytes of Bytes 
used left on 


diskette 


LBC 
Last Byte 
Count 


7D 


Byte 

Count 
in the 
last 

Block 
can be 
1L~80H 


80 
Highest 


Byte 
possible 


LADR 


load 
Adaress 


AOB2 


ILoad 
Address 


AZLB 


LOAD 
PROGRAM 
@ this 
address 


G2LD 
Not used 


in Data 
file 


SADR 


start 
Address 


PLSD 


Starting 
or Running 
Address 
used for 
PRG types 


ADZS 


jumps to - 
this address 
after it's 
loaded 


ZLIB 


Not used 
in Data 
file 


DISK BASIC 8001 


This is the same as the original BASIC SOO1 Ver. 12.8.76 with the 
Following extensions to allow complete use of the Intecelor File Control 
Systems or (FCS). “Phese extensions involve ont the Savi, LOAD and 
PRINT commands. For a detailed deseription of the FCS see the Intecolor 
FILE CONTROL SYSTEM Manual. 


The SAVE command is now in the form SAVE STRING where string can 
DG 8: Seine Variable Such Ve AS Or sas: a Guoled. dice ral. Simi usin as 


MNAME'. There are three FILE types that can be saved. Guy dave BAS LC 
source (BAS), numeric ARRAYS (ARY) and memory ALA (DAT). 1b no file 
type is specified then the deélault. tyne is BAS. ied eS Fale ee cam 


be in the following form. i SUVS LUG Soe PAG: POUL 


SAVE: MIEST’EREM- SAVES BASIC SOURCE WIT Wk “eer Of Dick 

SAVE. “FEST BAS" 

CAVE VTESTseaSer 

SAVE "TEST.BAS :''+STRS (V) -REM WHERE Vo TS . VARTABLE BEDIWEERN T AND 99 
SAVE AS: REM WHERE AS TS A Sip PING VARTADI 

SAVE AS+STRS (V):REM WHERE AS AND V ARE are 


The string sequence after the SAVE command ebeys all of the PRINT 
command foris of normal BASIC 8001, such as cencatenatien., 


The ARY file type can be in the same fourm as BAS except that ARY 
must be in the string after the file name. Aise the File name must be 
a dimensioned or previously used array by that same first two letters of 
the file name. If only one letter variable name is used then the file 
name must be that letter only. 


EXAMPLE: 10. DIM AT (100,10).7(3) ,?1(11,127,13 
20 SAVE. “ATEST ARY' 
30: SAVE a Ar 
A0 END 


The above will save the numeric arrays AT end T. 


The DAT file type can be in the same form as ARY. Tt will Tock at 
location 9E66H and YE67H (-24926 low byte and -24985 high byte) as a 
pointer to memory. It addg ] to this pointer and takes the next twe 
bytes in memory as the number of bytes to be saved on disk. The lcecatiens 
JEG6H and SEG/7H specify the end ef BASIC 6001] memory Space. so all memory 
above that lsecation can be used to gave data via BASIC 800] using the 
memory POKE command. 


This makes an ideal way to save text Or String information. The 
examples below are subroutines which will CREATE, OPEN or CLOSE a data 


ISC I@O —- 1077 


“Disk BASIC SOUL: “Cont. Page 2 


rile of NR Records (Number of Records) by RL (Record Length) character. 
DACA FILS SYSIEM POR DISK BASIC G00] Vik. 1250.76 


65000 REM FILE CREATE, FILE SIZE = # OF RECORDS *“ RECORD LENGTH, NR*RL 
65002 GOSUB65008: POKEP At] ,NRORL~ INT (URERL/ 2569256 

65003 POKEFA+2, INT (NR*RL/256) 

65004 POKEFAt+3 NR: POREFPAt ,RL:PORFT=5TONR RE : POKEFAtFI ,O:NEXT 
65005 RETURN:END CREATE 


65008 FAs256*“PEEK (-24985 )+PEEK (-24986 ) -65536 RETURN 

65009 END OF GOSUB 65008 

65010 REM PILE OPEN) TREN A ue ae VERS TON 

65012 “LOADPRINTAS: RE oe Moy “PLE isk oe Via 

65014 GOSUB65006 :hR= KOPAE3) RL ple] easit an URN ERD OF igor 


65020 REM FILE CLOSE, FILERAME, DAT ;VERSTON 
65022- SAVE AS:REM AS MUST =PILENAME ,DAT 3 VER 
“65024 RETURN:END OF CLOGGE 


65028 REM AS=GETS (RN ,RP,RC) 3 RNFREC 
65029 REM RGs Or CHARACTERS 

65030 ASS FOR T=1 ORCAS SASFOIRS OE RCP APAERNY “REERPEF &)) 
65031: NEXTERETURN= END “GEIS 


RO OuN, Ne Te 


c Th 3 


65038 REM PUT AS RN Poker ieee ee OF DATA, KNSRECORD: 4 
65039 REM RP= POSETION OF RECORD 
65040 FORFI=1TOLEN (AS) :POKEFAt4+RE“RLERDP+FI, ASC (MIDS (A$ , FI) ) 
65041 NEXT:RETURN:END PUT 


LOAD 

The LOAD command 1s now ef the form LDOADPRINT SPRING where String is 
either a string variable or 4 quoted diteral string. Like SAVE there 
are three types of LOAD conmands. They are BASIC source (BAS), numeric 
ARRAYS (ARY),and memory DATA (DAT). 


If no file type is specified then the default type is assumed to be 
BAS. The BAS type can be of the foellowiug Loria. Each example will cause 
a BASIC Source program to be loaded. 


LOADPRINT' PEST :REM LOADS A SASTC SOURCE ROCA BY NAMING OF TEST 
LOAD? "PEST" :REM IN BASIC €001 PRINT TS SAME AS 

LOAD Tests 

LOND? Ves. ase" 

LOAD? “TEST. BAS 3" +S1TRS(V):REM WHERE Vo IS AVATLABDLE BETWEEN 1 AND 99 
LOAD? AS:REM WHERE AS Ts A STRING VARTABLE 

LOAD? AS+HSTRS (V) REM \ HERE AS AND VO ARE VARTABLES 


Disk BASIC 8001, Cont. 


The string sequence after the LOARDPRINE (or 1.0AD?) command obeys 
all of the PRINT command forms of nomnal BASIC SOOl such as 


such ass 


10 LOADPRINT "PEST" SRUN 


Page 3 


conceatenation, 
The LOAD command can also be executed from the BASIC 8001 Source. 


This would load a BASTC 8001 souree by name of TEST and then execute 
that source program, NOTE: Any size program can load and RUN any other 
size program but variables cannot. be passed because the RUN command re- 


MELIIZes the: Variables: Li ywouwimel to tCiansier wariablies Tromone 


program to another you can use: 
IQ LOADPRANE "UES? sGOVO. 5 


This would load a BASTC 800] sourete: by name of TEST and 
\ 


statement 5 to start cxecution, without reinitializing the var 


the first program. 


then 


gcoes to 
Lables 440i 


NOTE: The second program must be the same size or smaller than the 
first program ii a GOO statvcment. 16: uecd artcr the: LOAD comiand, 
string variables defined in the first source as a Jiteral will not 


sarily be correct now, but calculated string variables will 


This process can be chain forever, so long as the first progr 


chain is the largest. 


be Cols 
ram aay the 


' The ARY file type can be in the same form as the BAS file.type, 


that ARY must be in the string after the file name. Also 


long as total size is compatible, 


Example: 10 DIMFENSTON AT (11005 


20 LOADPRIRY "ATEST.ARY’:REM ATEST-DIM (100,10) 


30 END 


1oned 


Aid 


PEL Ge tee 


aie i 
- e€ 


CXC Cie 
the file naine 
must be a dimensioned or previously used array py ENE Same name that is eithe; 
the same size or larger than the new array. NOTE: The dimens 
does not have to have the same number of dimensions as the Gdisk 


array 


array SO 


will cause a (100,10) array to be loaded even though AT was originally 


set as an J1I00, since 1100%7100 x lu, 


The DAT FILE type can be aa the same ferm as ARY. BASTC 
I 
at ORGGH and. SRO/T C=259°0 Low bere wad =2405> hie byte). 
tlic Hise two bytes 66 it ictal es a. ee es Tee ee 
The word at 9ROOH and GRGYH speciites che od of BASTC SOOL 
that al] memory above 
Also note that only oie DAP bile may be read in at any one 


at 2S CG ee ee eae 220: eid: “tay Gil 


Wilk. Case 
the file to be loaded inte merry Oy NRE at Clay Pocoe1 on al. speeit ved 
After loadin:s, 


Pie. 7S. 


Ge eee. 


Work Space, so 


ci sic. 
Cite wat pout 


Disk BASIC 8001, Cont. 


changing the pointer at 9F66H and 9FGO7H. 


PRINT 


Page 4 


By using the PRINT STRING comnand preccded by PLOT 27 and PLOT 4 or 
PLOT 68 (ESC,D for FCS DISK) BASIC &001 is able to exercise all of the 
FCS disk commands. Therefore every command available to the File Control 
System is also available to BASIC 8001, by Jetting the string become the 


FCS command. 
Example: To list the disk directory 


10 PLOT 27 
20 PLOT 4 
30 PRINT "DIR" 
40 END | 
: : Ors 
- 10. PLOT 27:PRINT'DDIR" 
Ors: 
10 PLOT 27:PLOT 68:PRINT AS:REM WHERE AS TS A 
20 REM STRING VARIABLE EQUAL TO DIR, 


NOTE: All of the above commands cause the same results. 


For example, suppose the Directory of the disk is as follows: 


TEST .DAT:01 
TEST .DAT;02 


Then the BASIC 8001 program below will delete version 1 of TEST DAT 


file, rename version 2 to version 1 update the data file and 
again as version 2 so it can be used again, | 


LO LOADPRINT “VESE.DAT <2" 

20 PLOIZ/ = 20) 44)EM SELECT hOo- MODE 

30 PRING “Di te Ves real sa 

20 PRINT "RENAME TEST. DAT 32 TO: TEST ay ea 

60 PLOY Z2ieVUOr 2 shit SEE Vis oe. CURSOR MODE 
70 SRE UPDATED DAA le Tir 

80 (°:REM UPDATE DATA FILE 

90 SAVE TIS. DAL 


e 


NOTES ALL Serine tunct ions thar: ave avai labie fo: DAS EC: 8001 -ean: be: used 


when generating the PRINT statement for FCS. 


Cave AL 


out 


To escape from the File Control System and retum to one of the other 


CRT modes then an Escape sequence must be yiven such as ESC 
CRT cursor mode, “ 


4y 
oo 


SC Lor 


Visible 


NOTE: The FCS responds only to ASCT] characters 


-odes: 


1d 
13 
26 
ae | 


ERWods 2 
CARRIAGE RETURN 


CURSOR ERT 


ESCAPE 


id 


ALi other control codes will. Cause <i 16S error, 


string. 


feed gye ») 


and the following control 


if they appear in a 


2090 3000 4000 5000 6000 7000 BO00 
f————— RAM CAR 


1000 


0000 


. v i 
Bd : ane 
i . it { : i! boy 
7 t j 3 , 
H : : : { 
i 


a kee aie tak PSS ee Neher ee Petit Va ee a a Od pee a ea ee de ne ee ee ier aeey ees ee Ore 


: : Ty t : Ee : : 

7 in% ASE a oie ae ee ee 

me ty ae co _ oe ; oa ie 
| oe 


2S IA bets IS A eb at a Eg Sh ES OE PS te et Ee ats Rg has) BL Sire bay Se ee AS 


, | “xz 
Py, fp. Tor 
Sica 


TAPE 
PROM O.S. 
PROM 


4K 


-NGTFLOPPY~ 
JON , 


INTECOLOR 8001/8052 W 


es ~~: 424K 
So PROG 


Ab ——————-— — F —. 


1 
; ’ : 
H 4 iad ‘ my 7 
boy eh ‘ i 
i] » r t 
i ie ae 
| rey 
ReaN A Me Bea) 


AN gt gaa MOET SH Pe BERRA Ae 1d MS 


a Le 
2 ee i : peat 
aoe a ee ee) 
i he ee: moat af 


me U ye Seige t 
: Sola ! 

i he VeEhel ns 4 
te i need 1 reba ‘ 


Seria te eee eke 


FE tee Lay SAA AG ITEC SRLS AP Oa ae ah EE IEE FTE GEN CL Reb Re es oa pc Rear ed 
‘; 1 


1 


BASIC =}. 


Pettdauy| te, 


eae 


FUT. 
{Prom ROM 


Gee 
Fees, 
| ‘ 


-~ {PROM 


i i ‘ 
Te a ce 
Pe ie Oe iia 
r oakk ot a Saw tbatdeed ts tea eae 


‘ 1 
sid 
} | cas 
{ Sod : 
i mal 
os 


1 a 
: F Lee ‘ ; . BE hee a ae Be ee y a 
' 2 Pang \ . types i as ‘ty ; {' : Senna 0 aaeked begat 
\ ne fy Ge Tas aay eg MiomeC rene. Pecwr oe kere e 
ee eee oe aes eed eee ee eee ee Pe aen 
: ‘ aut . or ue ae togoe jel 


a om ri ee } : $ 2 
EDP a RSIS eg Re ete ee tc ed TA len URS NN Bs Zs x LEE aaa LR Se 
te wm O 


aoe 
We NZa , 
mo. " 
po pee } ue ! . 
nod coe 
ee i 
it 


Ss. Se 
BE Ea Es Bhs eR: Oo. 
Oo 


t 


!: ; ht 


280 - - 
480 -- 
ele Gag Sommer 


600 - 
700 - 

800- - 
300--— 


FOOO 
: aR | 


& (#4e 


57 344 
EOOO 


8 ee oe RAM CARD 


4 


cad 
‘ees 


DOOO 


43: 


RAM CARD 


45452 
cooo 


BOOO 


$5¢5€ 


r 
BASIC RAM 


A000 
WORK AREA]: 


RAM CARD 


Ay 4EO 


9000 
; 


. 3684 


’ 
3 


3276€ 
BOO0O0 


j———-— RAM CARD 


7000 


CORRES cary te ee Bree 


Roive Mtg ges rt Hyp 


{ 
, 


! 


ence 


Ah BORSA ei, 8 SATA a 


SPACE: 
r 


SPACE “T 


_ Se 


| A aa ek Ged 


SPACE 
-Eb me 
RAM ~ 


ae 2S 2 


SPACE 
RAM 


-49273¢ A 


OR Te ee Oe. (SR Tete Eee ae os 


c™ 
aad 
Aa 


Isr | 
Ness | 


Hi 72E 


: in ‘ 4 th 
CABS LAB NS EENEAE ig elk RAEI Fn LY Bele ER AN OAET DR EAE, ERE Ee Bd a ache IB VOSA) 


14qRAM 
48 LINE 


~ 
the 


cn 


a 
i 


AREA 
+ 


48 LINE = 


esa 


OR 8001/8052 MEMORY MAP 


Pity -——-----—-- 4 -— 
s eee 


REM-GOTO6 : 
PLOT14:PLOT27:PLOT82:PLOT52:PLOT15 
PLOT2/:PLOT/2:POKE-24688, 86 


FORK=1T01500:NEXTK #£iS§ 


REM-A=* :B=* 


1 
2 
3 
: PRINT"XFER/A $TTI J":PLOT13 
6 
/ 


J=A-65536:K=B-65536 


WOnNDH OS WN 


FORN=JTOK 

X=PEEK(N) 
IFX>127THENX=0 4£ (@) 
IFX<32THENX=0 44 fej 
C$=CHR$(X):PRINTCS; 
NEXTN | 

REM 


Parr ys 
oe te Ey 


(START&STOP DECIMAL ADDR. OF RAM DUMP) 


REM-THIS PROGRAM WILL PRINT THE CONTENTS OF ANY 
REM-SECTION OF 8080 RAM SELECTED BY A & B. 
REM-ENTER S#1 TO RUN ON CRT, ELSE IT GOES TO 


REM-THE NOVA AS FILE “J". 
REM 
END 


REM-GOTO6 


PLOT14:PLOT2/7:PLOT82:PLOT52:PLOTI5 


PLOT27:PLOT72:POKE-24688,25 
PRINT"XFER/A $TTI J":PLOT13 
FORK=1TO1L500:NEXTKELIST 
REM-A & B HERE 
J=A-65536:K=B-65536:L=1 
FORN=JTOK:X=PEEK(N):PRINTX; 
L=L+1l:IFL=17THENPRINT:L=1 

NEXTN: PRINT 

REM 


REM--THIS PROGRAM WILL PRINT THE DECIMAL 
REM--EQUIVALENT OF ANY SECTION OF 8080 RAM 


REM--SELECTED BY A & B. 
REM--CLEAR S#1 TO RUN TO FILE 
REM 

END 


aa ay 


ON THE NOVA. 


i 
: 


LABEL V12.8.76 BASIC 
X%20D SE66-9E57 
M22 SE7A-9E73 
X225 SE7E-9ET7F 
X233 SE8C-9E8D 
X%235 SESE-SE8Fa 
Resd. 9E9O0-SE91 
eae - 9692-9693 
¥23B 9E94-—9E895 
“23D SE96-9E97 
eee NG oases Gees: 
X244 SE9D-9FBL 
: AOOOG-AQOG2 
G9EOO-GE6O 
9 5-OPN5 
ST DF-9SFE3 
103H 
LOFH 
122045 
S9EBTH 
9EAAH 


ISC 205-678 


Ve« 


CE9-f06A 
AQ7D-AO7E 
AO81-A082 
ACSF-AOIO 
AQS1L-AO092 
aO93-A094 
nO95-ACI6 
2097-A098 
AOS9S-AOIA 
AOIB-AOJE 
AQAOQ-AOQAC 
AUmaun7AOAP 

LOoH= 95 60 

PEOforiso 
SE De =r 52 
LO3H 
LOTR 


y 
Beaery sl 


S2B7H 
9EAHH 


IMPORTANT MEMORY COMPARISON TABLE 


DESCRIPTION PIELD 


EMG Oc Pa). = BOSS ,ocation BASIC uses 

Top of String File Space (moves as string is allocated) 
Current line numbers, is -l if immediate moces 

Top of Memory-50° Bytes where stack is set originally 
Pointer to start of text 

Pointer to start of simple variables 

Pointer £o start cf arrays 

BiG On Gera s 

Pointer to next data item 

PlLOating HOink accumu stor : | 

Floating point Dei cue, (3 byees) 

Call Routine from EASIC See IISc 149 

Biore Lh put Line Eo ee 

inoue: Piag = * : 

Keyboard Plag 

Console input Rowtine 

Console Out Routine 

Output String Routine 

User Console Output Device 

I/O Status Control Byte 


Ds 


HOW TO SAVE A DISPLAY 


Enter BASIC 8001 and type the following program: 


APLOT27:PLOT4:PRINT"SAVE@:SCREEN.DIS 8909~-9DFF":END (Return) 
NOTE: Screen can be any file name and .DIS is optional 
as 1s @ for drive number. 
Now type PLOT2:PLOT 255 (Return). This will put the display in 
the correct location so that the display memory location is at 
the top left corner of screen. 


Put the display on the screen to be saved. You can use the cursor 
control keys to correct all errors in the display. 


Now position the cursor so as to have about 4 lines by 5 characters 
each on the left area of the screen clear. Select Foreground and 
Background colors the same as the display color in this area. Type 
ESC E and then type RUN: and then Background, Black, Foreground, 
Red and then (Return). 

NOTE: You will not be able to see the characters you type in. 
After the display has been SAVED then READY will appear. 


Now that the display is saved on diskette you may erase the page. To 


recall the display to the screen, type ESC D and after the prompt 
message FCS> appears, you type: LOAD#:SCREEN.DIS and the whole 
display will be loaded onto the screen. 


NOTE: If the screen is to be generated from BASIC 8001 program, 
then the process could be simplified by just including the BASIC 
8001 statements at the end of that program, as in Step 1 above. 


